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CAPÍTULO 1 


Introdução 


O iPhone e o iPad são fenômenos. 

Não só seus marketshares possuem números impressionantes, mas também o 
número de vendas da App Store traz ânimo para nós, desenvolvedores. 

Mesmo com o número expressivo de dispositivos Android, é estimado que a App 
Store seja responsável por 85-90% do faturamento de todas os aplicativos móveis já 
vendidos (http://bit.ly/appstoreNumeros) , tendo revertido quase 4 bilhões de dóla- 
res aos desenvolvedores de iPad e iPhone. 

E o Brasil? De acordo com o site de análise mobile flurry.com, o mercado brasi- 
leiro atingiu, em 2012, a décima posição mundial em número de smartphones. São 
mais de 13 milhões de dispositivos, em sua grande maioria iPhones e Androids. Este 
site do Google pode agregar mais informações: 

http://www-thinkwithgoogle.com/mobileplanet/pt-br/ 

Você encontra mais sobre o marketshare de dispositivos móveis através dos sites: 
http://www.netmarketshare.com/ http://gs.statcounter.com/ 


Você pode estar lendo este livro para criar sua própria aplicação. Mas talvez esteja 
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procurando um novo emprego, para trabalhar com tecnologias novas. Esse também 
é um grande mercado, com um número de vagas crescendo. 

Para estar nesse mercado, seja com um emprego novo ou para desenvolver sua 
própria aplicação e colocá-la na App Store, você precisa saber programar para o sis- 
tema operacional iOS. 


1.1 DESENVOLVENDO PARA O IOS 


Em 2007, com o lançamento do iPhone, o sistema operacional que roda dentro do 
dispositivo tinha o criativo nome de iPhone OS. Com a evolução dos dispositivos e 
a chegada do iPad, o sistema mudou de nome para iOS. O iOS nasceu do já antigo 
sistema operacional, o OS X. 

Curiosamente, no início não havia como desenvolver para o iPhone. O kit de 
desenvolvimento, o SDK, só ficou disponível em 2008. Nessa época ele era pago, 
tornando-se gratuito em 2010 (apesar disso, os betas só podem ser utilizados pelos 
desenvolvedores que possuem uma conta paga na Apple). 

Para instalar o SDK e programar para o iOS, você vai necessariamente precisar de 
um computador que rode o OS X. Basicamente você só poderá desenvolver com um 
Mac. Sim, é um computador bem mais caro do que o valor que estamos habituados. 
Você pode comprar seu Mac em diversos lugares, sendo que alguns apresentam até 
preços melhores que na própria Apple Store. No caso de você ser estudante, há um 
desconto significativo de 10%, fique atento: 

http://store.apple.com/br/browse/home/education routing 

Atualmente o iOS SDK vem junto com a ferramenta que auxilia a desenvolver 
o código, a IDE, que se chama Xcode. Você fará apenas um único download que 


conterá ambos. Veremos esse processo de instalação no próximo capítulo. 


1.2 COMO O LIVRO ESTÁ ORGANIZADO E FOCADO 


Este livro aborda os pilares fundamentais de desenvolvimento para iOS, cobrindo 
desde a estrutura básica de um aplicativo, passando por detalhes da principal ferra- 
menta de desenvolvimento, o Xcode. Também veremos alguns tópicos mais avança- 
dos, como requisições de rede e execução concorrente de tarefas, além de detalhes 
da linguagem. Para você ter um melhor proveito desse livro, é importante já possuir 
uma boa experiência com uma outra linguagem de programação, e que se sinta con- 
fortável para utilizar estruturas de controle e atuar na solução de problemas lógicos. 


Casa do Código Capítulo 1. Introdução 





Uma das principais preocupações que tive ao escrever o livro foi balancear a pro- 
fundidade com a qual assuntos mais básicos e fundamentais são abordados, porém 
sem deixar de lado os leitores mais ávidos por detalhes técnicos. A apresentação 
de funcionalidades e recursos, inclusive da ferramenta de desenvolvimento, muitas 
vezes será feita de maneira orgânica, contextualizada em diversos aplicativos, o que 
possibilita a criação de exemplos relevantes e práticos. Foi dada muita atenção para 
a criação de material que lhe instigue a querer sempre continuar adiante. Todo feed- 
back é mais que bem vindo. 

Praticar é o segredo. Faça testes, use sua criatividade. Não se atenha aos diversos 
exemplos que temos aqui. Apesar de serem muitos, aproveite para criar e ir além. 


1.3 CÓDIGOS PARA DOWNLOAD E LISTA DE DISCUSSÃO 


Todos os projetos apresentados no livro estão disponíveis para download no ende- 
reço https://github.com/rafaelsteil/livro-ios-exemplos, incluindo as eventuais corre- 
ções e modificações. Além disso, criamos uma lista para perguntas e respostas tanto 
sobre o livro quanto sobre programação para iOS em geral. O acesso é livre, através 
do seguinte endereço: 


https://groups.google.com/d/forum/programacaoios 


CAPÍTULO 2 


Hello World, seu primeiro programa 
em iOS 


Aplicativos para iOS seguem uma estrutura relativamente simples, se formos com- 
parar com aplicações que rodam em um browser ou no desktop. Além disso, ao 
contrário de outros sistemas mobile, como Android, detalhes no iOS são mais pa- 
dronizados, existindo uma quantidade muito menor de dispositivos e resoluções de 
tela, o que simplifica muito a vida na hora de criar aplicativos. Quem já fez aplica- 
ções para a web sabe o quão difícil é criar um sistema que funcione bem em diversos 
tamanhos de telas, configurações variadas dos computadores e, além disso tudo, em 
diferentes browsers. Com iOS estes problemas são muito menores, pois se você fizer 
um aplicativo para iPhone, poderá ter a certeza que ele rodará da mesma maneira 
para todos os usuários. Claro, a medida em que o sistema vai evoluindo e novas ver- 
sões são lançadas no mercado, temos que lidar as variações de processador, memória 
e densidade de tela. 
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COMPREENDENDO MAIS A FUNDO RESOLUÇÕES E DENSIDADES 
DE PIXEL 


Uma leitura muito interessante é o post “Pixels, pixels ou pixels?” na 


URL http://bit.ly/A6odLG. 











O código-fonte deste capítulo está disponível na pasta “Hello World” (lembrando 
que o endereço do site com os códigos está na introdução do livro). 


2.1 INSTALANDO A FERRAMENTA DE DESENVOLVIMENTO - 
XCODE 


A Apple disponibiliza gratuitamente todas as ferramentas e documentação para de- 
senvolver para iOS, incluindo um simulador de iPhone e iPad que funciona incri- 
velmente bem, além do Xcode, que é onde todo o código é escrito e compilado. A 
maneira mais fácil de obter o Xcode é através da Mac App Store, disponível desde 
versão 10.6.6 do OS X. 

Basta procurar por “Xcode” e instalar gratuitamente. Ou acesse o website da 
ferramenta e clique em “View in Mac App Store": https://developer.apple.com/xcode/ 

Vale lembrar que o Xcode já contém todas as ferramentas do SDK para o iOS (e 
para o OS X também!). 


2.2 SEU PRIMEIRO PROGRAMA 


Nesta seção vamos ver como criar uma simples aplicação para iPhone, do início ao 
fim. O principal intuito é introduzir as principais telas e funcionalidades do Xcode, 
e ir se familiarizando com o editor de códigos e sintaxe da linguagem. Para todos os 
projetos deste livro foi utilizada a versão 5 do Xcode. 

Crie um novo projeto no Xcode (File -> New -> Project), e escolha o template 
Single View Application, conforme a figura 2.1, e depois clique em Next: 
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Choose a template for your new project 


Bios 
lata = Q eoo 1 
Framework & Library 
Other 7 
Master-Detail OpenGL Game Page-Based Single View 
K osx Application Application Application 
Fj Application 
pennen m 
| Framework & Library me Ea Fi 
f | Application Plug-in k ce. 4 A- 
7 System Plug-in 
í Other Tabbed Application Utility Application Empty Application SpriteKit Game 
pt 
EE 
J 
| 
læ 
E 
E 
| | 7 | Single View Application 
Ea This template provides a starting point for an application that uses a single view. It provides a 
E view controller to manage the view, and a storyboard or nib file that contains the view. 
Cancel Previous | NS) 


Figura 2.1: Selecionando o tipo de projeto a ser criado 


Na próxima tela, demonstrada na figura 2.2, devemos inserir algumas informa- 
ções básicas a respeito do projeto, como nome (Product Name), identificador da em- 
presa (Company Identifier), e um prefixo para a classe (Class prefix). Insira os valores 
“Hello World”, “com.teste” e “HW” respectivamente. 

O Product name é o nome do projeto (que depois pode ser customizado), o 
campo Company Identifier é o identificador do projeto que será utilizado na iden- 
tificação técnica do produto quando você for cadastrá-lo junto à Apple, no iTunes 
Connect. Todo o processo de registro do aplicativo e utilização do iTunes Connect 
serão abordados mais adiante no livro. Não há uma regra específica para o valor 
deste campo, exceto que ele deve ser único. Porém, como convenção, costuma-se 
utilizar algo parecido como os packages do Java, normalmente o endereço web da 
empresa, seguido do nome do projeto. Repare que existe um label embaixo cha- 
mado Bundle Identifier, que é a junção do Company Identifier com o Product Name. 
Estas informações serão úteis mais adiante quando formos cadastrar o produto no 
iTunes Connect, mas por enquanto não se preocupe muito com os valores que for 
utilizar, já que estamos apenas criando um aplicativo de testes. 


2.2. Seu primeiro programa Casa do Código 








Choose options for your new project: 
Your company's name — = E 





Product Name HelloWorld 





Organization Name Minha Empresa 





Company Identifier com.teste 


Bundle Identifier com.teste.HelloWworld 


Devices | iPhone +] 














| Cancel | | Previous |E Net] 


Figura 2.2: Informações sobre o projeto 


Por sua vez, o campo opcional Class Prefix denota uma boa prática de progra- 
mação Objective-C, que é a de colocar um prefixo no nome de todas as classes para 
evitar conflitos de nomes. Quem está acostumado com linguagens como Java, C# ou 
mesmo C++, tem um aliado a mais para evitar este problema, que são os packages ou 
namespaces. Em Objective-C não existe este conceito, portanto precisamos garantir 
que não existam nomes duplicados em nosso projeto e — muito importante — em 
nenhuma outra biblioteca de que façamos uso. Caso ocorra um conflito de nomes, 
o compilador irá acusar um erro e terminar o processo de compilação do programa. 
No caso deste exemplo, foi utilizado o prefixo HW, de Hello World. 

Por último, selecione “iPhone” no campo “Devices”, pois este aplicativo será ape- 
nas para iPhone. As outras opções possíveis são “iPad” e “Universal”, que é um tipo 
de projeto que pode rodar tanto em iPhone quanto em iPad. 

Clique em Next, e o Xcode pedirá para você salvar o projeto. Escolha o diretório 
de sua preferência e clique em “Create” 

Neste ponto já temos o projeto criado com as definições padrão, e você deverá 
ver uma tela parecida com a da figura 2.3. 
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eoe E3 HelloWorld.xcodeproj e 
D E | A) iPhoneRet. | HelloWorld: Ready | Today at 1:14 AM No Issues E [Es PA mem | 

umas so =» 4 > | EB HelloWorld | D B 
m E ow sessaza DD Ar? General Capabilities Info Build Settings | Quick Help 
targets, 4 
v C HelloWorld Y Identity 
[R] HwappDelegate.h o Quic elp 
= pç Bundle Identifier [com.teste.HelloWorid 
n.s r 
[h] HwviewController.h Version |1.0 
[m] HWviewController.m PR 
(E) Images.xcassets - 
> C] Supporting Files Team (None TES 


> C HelloWorldTests 
> C Frameworks 
> C Products 





a 
+ 08(9 


Fix Issue mouse-down events and sends an 
action message to a target... 
Y Deployment Info 
— Rounded Rect Button - 
Intercepts mouse-down events 
and sends an action message to... 
Deployment Target |7.0 X 


A No matching code signing identity found PARN BAO AENEAS 
mouse-down events and sends an 


action message to a target.. 


5 


No codesigning identities (i.e. cer 
matching “iPhone Develope: 

this issue by downloading a new provisior 
Member Center. 





Gradient Button - Intercepts 


Devices | iPhone 2) 








Figura 2.3: Tela do Xcode após a criação do projeto 


O projeto foi criado com 5 arquivos: 


* HwAppDelegate.he HWAppDelegate.m 


e HWViewController.he HwViewController.m 


e Main.storyboard 


A classe HwWAppDelegate éa responsável por, dentre outros, eventos de iniciali- 
zação e término do aplicativo. É esta classe que inicializa o nosso controller principal 


e permite que o usuário possa utilizar o aplicativo. 


A classe HwViewController é o nosso controller principal, responsável por 
gerenciar diversos eventos do aplicativo — como rotação, navegação para outros 
controllers e gerenciamento da view —, e é uma das classes com que mais traba- 


lharemos ao construir aplicativos para iOS. 


Por último, o arquivo Main.storyboard é utilizado para desenhar a tela do 
aplicativo. Mais adiante no livro veremos a fundo o funcionamento de storyboards, 


por enquanto basta saber que é nele onde as telas serão criadas. 
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2.3 DANDO VIDA AO APLICATIVO 


A ideia deste aplicativo é esconder e mostrar uma tela (view) através do toque em 
um botão. No fim, teremos visto: 


1) Como customizar a tela do controller principal 
2) Como adicionar elementos na tela utilizando o Storyboard 
3) Como lidar com eventos de botões 


4) Como fazer uma animação simples 





EDITOR VISUAL DE TELAS 


Até a versão 3 do Xcode, as telas eram representadas apenas por ar- 
quivos com a extensão .xib, e editados através de um programa à parte 
chamado Interface Builder. Porém, a partir da versão 4, ele foi integrado 
diretamente com o Xcode. Existem diversas formas de integrar a parte 
visual de um arquivo .xil com o código-fonte propriamente dito, o que 
pode causar um pouco de confusão no início do aprendizado. 

Além disso, a partir do Xcode 4.2 a Apple introduziu o conceito de 
Storyboards, possibilitando assim a criação e gerenciamento de todas as 
telas do aplicativo em um único arquivo, ao invés de diversos “xibs”. De 
qualquer maneira, Xibs continuam sendo uma maneira totalmente vá- 
lida de criar interfaces. 

Aqui no livro detalharemos os passos necessários para que você não 
fique perdido com a quantidade de informações, porém não se apegue a 
uma única maneira de desenhar as interfaces, e não desanime caso pareça 
difícil no início. Rapidamente você verá que o fluxo é bastante lógico, e 
passará a trabalhar com mais produtividade. 











Para começar, vamos criar os elementos gráficos que serão manipulados. Para 
isso, clique no arquivo Main.storyboard, e você deverá ver uma tela como a da 


figura 2.4. 
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eoe E HelloWorld.xcodeproj — [E Main.storyboard al 
HelloWorld: Ready | Today at 1:14 AM No Issues | 


> m> B> B> E view Control... > @ view Controller 
y p HelloWorld Simulated Metrics 
2 targets, iOS SDK 7.0 
v C HelloWorld 

[R] HWAppDelegate.h Orientation [ Inferred 
[m| HWAppDelegate.m Status Bar | Inferred 
[E Main.storyboard Top Bar [ Inferred 
[h] HWviewController.h 
[m] HWviewController.m 





size | Inferred 


Bottom Bar | Inferred 


> C HelloWorldTests 
> C] Frameworks Initial Scene [4 Is Initial View Controller 


> C Products DOS m 
View Controller - A controller 


that supports the fundamental 
view-management model in... 








Table View Controller - A 
controller that manages a table 


View Controller view. 


Collection View Controller - A 
controller that manages a 
collection view. 





(a) (B )] [S | |re1| E] (& 

















Figura 2.4: Tela inicial do Interface Builder 


Os componentes que podem ser adicionais na view, como outras views, botões, 
seletores de opções, campos de texto e afins estão disponíveis na Object Library, 
acessível através do menu View -> Utilities -> Show Object Library, 
que por padrão estará localizada no canto inferior direito, conforme a imagem 2.5. 
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D aereo 
Simulated Metrics 

Size | Inferred : 

Orientation | Inferred i 

Status Bar | Inferred , 

Top Bar Inferred $ 


Bottom Bar | Inferred ç 


View Controller 


Title 


DO ğ Æ 


View Controller - A controller 
that supports the fundamental 
view-management model in... 


Collection View Controller - A 
controller that manages a 
collection view. 








Table View Controller - A 
controller that manages a table 
view. 

ATTE, 


Figura 2.5: A Object Library 


Nesta lista, selecione o componente View (que é uma instância da classe 
UIView) e arraste-o para a tela do iPhone. Ao fazer isso você notará que o Xcode 
tentará adicionar a view de tal forma que preencha todo o espaço disponível, porém 
é possível mudar o tamanho sem problemas. Feito isso, selecione o Size Inspector 
através do menu View -> Utilities -> Show Size Inspector, que deverá estar localizado 
no canto superior da tela. Esta janela permite alterar diversas propriedades do com- 
ponente, como tamanho e posição, cor de fundo e transparência. Por hora, mude 
o tamanho nos campos Width e Height para 280 e 150, respectivamente, e 
posicione-o no xe Y 20. Você pode fazer esta operação com o mouse também. 

Repare que tanto o fundo da tela quanto a view que acabamos de adicionar tem 
fundo branco - um fantasma numa tempestade de neve. Para trocar a cor de fundo da 
view selecione o Attributes Inspector em View -> Utilities -> Show Attributes Inspector, 
e em seguida mude o campo “Background” para preto, ou qualquer outra cor que lhe 
agradar. 
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DB ES oO 
View 


Mode | Scale To Fill 


ar 


Tag olls 


Interaction TA User Interaction Enabled 
Multiple Touch 


Background 





Drawing TA Opaque Hidden 
TA Clears Graphics Context 


Figura 2.6: Localização da cor de fundo do componente, no Attributes Inspector 


O próximo passo é adicionar dois botões, um para esconder a view, e outro para 
mostrá-la novamente. Os botões são do tipo UIButton. Na paleta de componentes, 
eles estão listados como Button. Botões podem ser transparentes também, assim 
como utilizar uma imagem como fundo. O primeiro botão será chamado Esconder, 
e o segundo será chamado Mostrar. Existem duas formas de fazer isso pelo Interface 
Builder: dando dois cliques em cima do botão e inserindo o texto; ou acessando View 
-> Utilities -> Show Attributes Inspector e preenchendo a propriedade Title. 





ATTRIBUTES INSPECTOR 


O Attributes Inspector permite definir diversas propriedades dos com- 
ponentes, variando de acordo com o tipo de cada um. Por hora, apenas 
o título do botão nos interessa. 











Após ter feito estes passos, a tela deverá estar como a figura 2.7. 
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Esconder Mostrar 


Figura 2.7: Estado da view após adicionar os componentes 


2.4 ÅSSOCIE SUA TELA COM O CÓDIGO 


Uma vez tendo criado a tela, é necessário associar os componentes com o código 
propriamente dito. Para isso o Xcode fornece algumas facilidades de arrastar e sol- 
tar que nos livram de escrever código repetitivo o tempo todo. Os passos são os 
seguintes: 


1) Ativar o Assistant Editor do Xcode 


2) Esconder telas desnecessárias 
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3) Ligar os componentes com o código-fonte 


O primeiro passo é ativar o Assistant Editor (“Editor assistente”, em uma tradução 
literal) do Xcode, que é um modo de trabalho no qual podemos ver ao mesmo tempo 
tanto a interface gráfica quando o código-fonte. Acesse o menu View -> Assistant 
Editor -> Show Assistant Editor (tecla de atalho Option + Command + Enter), 
o que deverá mostrar uma nova tela com o arquivo HwViewController.hao lado 





da interface gráfica que acabamos de montar. 





TECLAS DE ATALHO 


Repare que muitos dos menus têm teclas de atalho, que são grandes 
aliadas dos programadores. Mais adiante no livro veremos uma relação 
de diversas teclas de atalho bastante úteis no dia a dia. 











A figura 2.8 mostra como fazer o mesmo procedimento utilizando botões exis- 


tentes no Xcode. 





World.xcodeproj — |B) Main.storyboard m 
»day at 1:14 AM N E HA L fd Li 
C> E) > B Main.storyboard (Base) > No Selection D BE Pp $ O 





DU ğ Æ 


o li avanavie m menace Duruer. 


Label - A variably sized amount 
Label of static text. 


Figura 2.8: Botão para ativar o editor assistente 
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Agora, se você estiver com as configurações padrões do Xcode, a tela deverá estar 
uma confusão como a da figura 2.9, especialmente se o seu monitor não for muito 
grande. 


eoo E3 HelloWorld.xcodeproj — Ẹ Main.storyboard 
























E 
D DM | A) g iPhone Ret.. | HelloWorld: Ready | Today at 1:14 AM No Issue E a. Dao 
nnQqQaCO = Ee lui<rBORBBnmiscrimoli<«2»na D e 
HelloWorld 147 Quick Help 
2 targets, iOS SDK 7.0 2 4! HwViewController.m 
X [3 HelloWorld 3 H HelloWorld E 
(h) HWAppDelegate.h 4! Created by Rafael St e 


[m] HWAppDelegate.m 6 // Copyright (c) 2013 M 
[h] HWViewController.h 9 #import "HWViewControlle 
[m] HWViewController.m M 
Images.xcassets 





1 Ginterface HWViewControl 





> C] Supporting Files 3 end 
P fai Helioworidtests 1s Cimplementation HWiewCc 
> C] Frameworks 1 
> C Products 17 - (void)viewDidLoad D e E 
18l { NI aranan erra vemos: 





[super viewDidLoad] ; 
4! Do any additional 
} ida ca 
Label Label - A variably sized amount 


x of static text. 
- (void)didReceiveMemor) 
t 


2 [super didReceiveMen 
Esconder 26 // Dispose of any re Button - Intercepts touch events 
2 Button and sends an action message to a 
target object when it's tapped.. 





9 Gend 
z Segmented Control - Displays 
| multiple segments, each of which 
tri Bj/a = a functions as a discrete button. 
Co TF RR 
+ 1086 | 26 


Figura 2.9: Editor bastante confuso do Xcode 


Podemos simplificar isso escondendo as telas Navigator e Utilities, que ficam à 
esquerda e à direita, respectivamente. Para isso, selecione o menu View -> Navigators 
-> Hide Navigator e View -> Utilities -> Hide Utilities. 
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VERIFIQUE SE O ARQUIVO FONTE SELECIONADO ÉO.H 


Importante: os passos a seguir devem ser feitos com o arquivo “ 
HWViewController.h” selecionado no Assistant Editor, porém algu- 
mas vezes o Xcode abre inicialmente o arquivo “ .m”. Para efetuar a troca, 
clique no nome do arquivo na barra superior de navegação, e selecione 


“HWViewController.h” conforme exemplificado nas imagens 2.10 e 
2.11 





— [É Main.storyboard 


No issues EE 


> | [E] Automatic > [m] HWViewController.m > No Selec 
import "HWViewController.h" 





interface HWViewController () 


end 


implementation HWWiewController 


Clique 


(void)viewDidLoad 


Figura 2.10: Barra de seleção de arquivo 


Dj — |B) Main.storyboard 





No Issus E] E 


4 | [E Automati [m] HWViewController.m seles 


frimport “HWV iewCo R E eres do 


Ginterface HwvViewControlter () 
Gend 
Gimplementation HwViewController 


- (void)viewDidLoad 
{ 


Figura 2.11: Selecione o arquivo .h 








Para conectar cada botão com uma ação no código-fonte faça o seguinte: 
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Selecione o botão Esconder no Interface Builder 


Segure a tecla CTRL, depois clique com o botão esquerdo do mouse e arraste. 
Você verá que uma linha aparece na tela. 


Arraste a linha para o código-fonte à esquerda (arquivo 
HWViewController.h), posicionando-a logo abaixo da declaração 
Ginterface, e solte o mouse. Veja a figura 2.12 para referência visual destes 
passos. 


Deverá aparecer uma janela flutuante como a da figura 2.13. Selecione a opção 
Action em Connection, e no campo Name insira o valor hideView, que é o 
nome do método que criaremos para manipular o aplicativo. 


Deixe o resto dos campos com os valores padrão, e clique no botão Connect 


Repita a operação para o botão Mostrar, e no campo Name preencha com 




















showView 
e0oo E3 HelloWorld.xcodeproj — |E) Main.storyboard 
> a A > Cê iPhone Ret... HelloWorld: Ready | Today at 1:14 AM No 3 g nA | pM] 
E- «4 Bm BB [=] View Button - Esconder im | 4 > | [E] Automatic | [h) HWvViewController.h > No Selection 42» 
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fimport <UIKit/UIKit.h> 








interface HwiewController ; ilVisuControlter 


Insert Outlet, Action, or Outlet Collection 





2 - CTRL + clique e arraste 


1 - Selecione 


Mostrar 


Figura 2.12: Ligando a ação do botão ao código 
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Connection | Action ) $ 
Object (E) view Controller ! 


Name | hideView b 


Type (id x 


M 


d 


f 
p 


mm 


Event | Touch Up Inside 


Arguments | Sender 


Cancel Connect 





ET 


Figura 2.13: Popup para inserir ação a um botão 


A última coisa que falta para que possamos começar a colocar a mão no código 
é associar a UIView com o código. Faça o mesmo procedimento realizado para 
os botões (selecionar, depois CTRL + arrastar), porém selecione Outlet no campo 
Connection, e em Name insira o valor workingView. O resultado final do arquivo 
HWViewController.h deverá ser como o da listagem abaixo: 


# import <UIKit /UlKit.h> 


Ointerface HwWViewController : UlViewController 
- (IBAction)hideView: (id)sender; 
- (IBAction)showView: (id)sender; 


Oproperty (weak, nonatomic) IBQutlet UlView *workingView; 


@end 





OUTLETS 


Outlet é a denominação que o Interface Builder utiliza para se re- 
ferenciar a um componente no arquivo .storyboard ou .xib que 
é referenciado no arquivo .h, onde é representado pela palavra-chave 
IBOutlet. Ele é tratado de forma especial pelo Xcode. Sem os outlets, 
não seria possível acessar os componentes criados. 











Estamos na reta final do nosso primeiro aplicativo para iOS. O que devemos fazer 
agora é criar o código que irá esconder e mostrar a view de acordo com os botões. 
Para isso precisamos trabalhar no arquivo HWwViewController .m, que é onde fica 
o código de fato. 
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ARQUIVOS .H E .M 


Ao contrário de linguagens como Java e C#, o Objective-C (assim 
como C e C++) requer um arquivo para as definições gerais da classe, e 
outro para o código de fato, tendo a extensão .he .m respectivamente. 
No capítulo sobre a linguagem veremos mais a fundo o funcionamento 
deles. 











Para alternar para o arquivo .m( HWViewController.m), abra novamente o 
painel Navigator (View -> Navigators -> Show Navigator, ou Command+o0) e seleci- 
one o arquivo na listagem. Caso queira fechar o Assitant Editor e voltar para o modo 
de edição com um único arquivo por vez, selecione View -> Standard Editor -> Show 
Standard Editor (ou Command+ENTER). 











Repare que o código do arquivo HwWViewController.m já contém o esque- 
leto dos métodos hideViewe showView, que foram criados pelo Xcode quando 
conectamos os componentes do arquivo Main.storyboard com o arquivo .h. 


2.5 ESCONDENDO E MOSTRANDO A VIEW 


Como a nossa workingView já se inicia visível, vamos primeiro fazer o código para 
escondê-la. Para isso, implemente o método hideView conforme exemplo abaixo: 


- (IBAction)hideView: (id)sender { 
self .workingView.alpha = 0; 


É um código bastante simples e autoexplicativo, em que mudamos a opacidade 
do componente para o, tornando-o assim invisível ao usuário. Já o código para mos- 
trar novamente o componente consiste em fazer a operação contrária — ou seja, 


mudar a propriedade alpha para o valor 1, conforme mostra a listagem abaixo: 


- (IBAction)showView: (id)sender { 
self .workingView.alpha = 1; 


Para compilar e rodar o aplicativo no simulador do iPhone, selecione o menu 
Product -> Run ( Command+R). O resultado deverá ser como o da figura 2.14. 
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iOS Simulator - iPhone Retina (3.5-inch) / iOS 7.0.3 (118508) 
Carrier = 2:29 AM ad 








Esconder Mostrar 








Figura 2.14: Resultado do primeiro aplicativo para iPhone 


2.6 ADICIONAR ANIMAÇÃO 


Para finalizar este primeiro aplicativo, podemos tornar as operações de esconder e 
mostrar o componente algo visualmente mais agradável, através de animações. Para 
tanto, modifique os métodos conforme o exemplo abaixo: 


- (IBAction)hideView: (id)sender 1 
[UIView beginAnimations:nil context:nil]; 
self.workingView.alpha = 0; 
[UIView commitAnimations]; 


21 


2.7. Bônus - Acessar a documentação de dentro do Xcode Casa do Código 





- (IBAction)showView: (id)sender 1 
[ULView beginAnimations:nil context:nil]; 
self .workingView.alpha = 1; 
[UIView commitAnimations]; 


Rode no simulador novamente ( Command+R) e veja a diferença. Muito melhor, 
não?! 


2.7 BÔNUS - ACESSAR A DOCUMENTAÇÃO DE DENTRO DO 
XCODE 


A API do iOS é enorme, e simplesmente não há como sabermos de memória o nome 
de todas classes, métodos, propriedades e as infinitas regras que os regem. Para isso 
existe a documentação, e o Xcode torna bastante fácil o acesso a ela: basta abrir o pai- 
nel Quick Help (“Ajuda rápida”, literalmente) através do atalho Option + Command 
+ 2, ou através do menu View -> Utilities -> Show Quick Help Inspector, e depois cli- 
car no editor de códigos em cima da classe a cuja documentação se deseja ter acesso, 
conforme mostra a figura 2.15. 





eoo F} HelloWorld.xcodeproj — [h] HWViewController.h | 
D E | A) iPhoneRet. | Running HelloWorld on iPhone Retina (3.5-inch) No Issue O eA m A | 
< > | EB HelloWorld > [7] HelloWorld > [Ñ] HWViewController.h » [E] @interface HWViewController 
1 #import <UIKIt/UIKIt.h> trass vasea Ur tre speomit 
task each subclass 
interface HWiewController : UIViewController performs. 
a — (IBAction)hideView: (id) sender; 






Availability iOS (2.0 and later) 
lêt UlView +workingView; Declared In UlViewController.h 


Reference UlViewController Class 
Reference 


5 -— (IBAction)showView: (id)sender; 
6 property (weak, nonatomic) IB 


gend 






ew Controller Catalog for 
OS, View Controller 
Programming Guide for OS 
+ ÌOS 7 UI Transition Guide 
Sample Code AdvancedURLConnections, 
GLAirplay, UnwindSegue, 


Posicione o mouse em 
cima do elemento desejado 





Sgp avanavre m merae punuer; 


Label - A variably sizedamout À 
Label of static text. 


Clique para abrir a 
H Button - Intercepts touch events 
ajuda completa Button and sends an action message to a 
target object when it's tapped. 
Segmented Control - Displays 
multiple segments, each of which 
functions as a discrete button. 


na z E Al E A HelloWorld ce (mm 











Figura 2.15: Acessando a ajuda rápida 
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CAPÍTULO 3 


Mais Objective-C e Xcode 


Agora que já vimos a estrutura básica de um aplicativo iOS, tendo passado pelo pro- 
cesso de criação de um projeto, algumas teclas de atalho e funcionalidades do Xcode, 
vamos dar um passo adiante e criar um aplicativo um pouco mais elaborado. Ao 
mesmo tempo, exploraremos mais a fundo o Xcode e, principalmente, a linguagem 
Objective-C. Detalharemos mais a linguagem de programação, porém sem entrar 
em aspectos avançados, o que é feito no capítulo 11. 

O aplicativo que iremos criar consiste no cadastro de empresas para um catálogo, 
mostrando a listagem de todas empresas cadastradas cada vez que um novo registro 
é inserido. A figura 3.1 mostra onde chegaremos com o nosso aplicativo. Durante 
a construção deste, não deixe de testar ideias e deixar sua curiosidade ajudá-lo a 
aprender mais. 


3.1. Criando o projeto Casa do Código 





| iOS Simulator - iPhone Retina (3.5-inch) / iOS 7.0.3 (118508) 
Carrier = 3:53 AM ld 
Nome da empresa 





Funcionários 0 [= [+] 





Salvar 


Dados salvos com sucesso 








Figura 3.1: O aplicativo que iremos construir 


O código-fonte deste capítulo está disponível na pasta “CatalogoEmpresas” (lem- 
brando que o endereço do site com os códigos está na introdução do livro). 


3.1 CRIANDO O PROJETO 


Abra o Xcode e crie um novo projeto através do menu File -> New -> Project (tecla 
de atalho SHIFT + Command + N) e selecione o tipo Single View Application e clique 
no botão Next. Na próxima tela insira o nome CatalogoEmpresas no campo Pro- 
duct Name, em Company Identifier coloque com.test.e, deixe o campo Class Prefix 
em branco e selecione “iPhone” em Device Family. Veja a figura 3.2 para referência. 





Clique em Next para salvar o projeto. 
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Choose options for your new project: 








Product Name | CatalogoEmpresas 


Company Identifier |com.teste 





Bundle Identifier com.teste.CatalogoEmpresas 





Class Prefix |XYZ 





Devices | iPhone 2 











| Cancel | | Previous | Net |] 


Figura 3.2: Opções do novo projeto 





Os DIFERENTES TEMPLATES DE PROJETOS 


Apesar do nome, o template de projeto Single View Application (ou 
“aplicação com uma única view”) não é limitado a uma única tela, mas 
sim que o código inicial que o Xcode irá criar para você terá uma tela ini- 
cial, ficando a cargo do desenvolvedor criar o que mais precisar. Os ou- 
tros tipos de templates seguem a mesma lógica, porém adicionando por 
padrão algumas coisas a mais, como o a Tabbed Application, que cria a es- 
trutura base para um projeto que use uma “tab bar” (aquele componente 
com uma barra inferior com vários ícones), ou a Utility Application, que 
cria um projeto já com duas views e um botão para alternar entre elas. 

Nos exemplos deste livro iremos sempre utilizar a Single View Ap- 
plication por ser a mais prática para os propósitos apresentados. Aliás, 
este muito provavelmente será o template que você mais utilizará quando 
criar seus próprios aplicativos. 
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3.2 ENTENDA MELHOR A INTERFACE DO XCODE 


A figura 3.3 mostra a estrutura geral do Xcode, com os possíveis painéis de trabalho 
abertos, sendo que cada um destes painéis é utilizado para diferentes propósitos — 
nessa figura, apresentamos apenas uma das combinações possíveis, que é a seguinte: 


1) Navegador do projeto, ou apenas Navigator, o qual contém a relação de arquivos 
do projeto ( Command + 1), erros de compilação, logs, busca e outras funcio- 
nalidades. Tecla de atalho: command + 1 para abrir, e Command + 0 para 
esconder (menu View -> Navigators para a relação completa) 


2) Editor principal de código e criação de telas, chamado oficialmente de Stan- 
dard Editor. Dependendo da configuração pode mostrar mais de um arquivo ao 











mesmo tempo. Tecla de atalho: Command + ENTER. Para alternar para o modo 





de trabalho em par, no qual a tela fica dividida entre dos arquivos diretamente 





relacionados, a tecla de atalho é Command + Option + ENTER. 











3) Painel de debugging (“depuração”) e mensagens de log geradas pelo aplicativo. 
Teclas de atalho: Command + SHIFT + Ye Command + SHIFT + C (menu 
View -> Debug Area) 





4) Painel Utilities, o qual contém utilidades gerais de acordo com o arquivo aberto 
no Standard Editor, tais como documentação (quando editando código-fonte) ou 
propriedades de algum componente visual (quando editando arquivos .xib) 


5) Botões de acesso rápido para os editores e painéis já descritos. 
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eoo E CatalogoEmpresas.xcodeproj — [m] ViewController.m 
> M| | Ay) [$ iPhone Retina (3... CatalogoEmpresas: Ready | Today at 2:59 AM 





No Is: 





uzam m | 4 > | EB CatalogoEmpresas » [7] CatalogoEmpr. 
CatalogoEmpresas 
2 targets, iOS SDK 7.0 Gr TE 
3 interface ViewControlter 
vw [ | CatalogoEmpresas x 
[R] AppDelegate.h 5 [end 
pu 
ea knimplementation Viewcontroller 2 Location | Relative to Group +] 
| Main.storyboar 8 = 
> ViewController.m E 
a (void)viewDidLoad 
[B] ViewController.h i Full Path /Users/rafael/Desktop/ 
[5 ViewController.m Isuper viewDidLoad); ios book examples/ 
(E) Images.xcassets 44 Do any additional setup after loading the view, typically from a CatalogoEmpresas/ 
> C Supporting Files 


CatalogoEmpresas/ 
ViewController.m 

> [ ] CatalogoEmpresasTests (void)didReceiveMemoryWarning 

> C Frameworks 


> C Products [super didReceiveMemoryWarning] ; arget Membership 
3 // Dispose of any resources that can be recreated. 


[m] ViewController.m » No Selection 


Name | ViewController.m 


Type | Default - Objective-C... + | 


M A CatalogoEmpresas 
FA ratalnnnFmnresasTests 


1 o E 


View Controller - A controller 
that supports the fundamental 
view-management model in.. 


Table View Controller - A 
controller that manages a table 
view. 


Collection View Controller - A 
controller that manages a 
collection view. 








Figura 3.3: Os painéis do Xcode 





TERMOS EM INGLÊS 


Ao referenciar menus e opções do Xcode utilizaremos primeiro o 
termo original em inglês e, quando pertinente, uma tradução literal em 
português, pois desta forma será mais fácil para você procurar ajuda e 
documentação na Internet, mesmo que não domine totalmente o inglês. 











3.3 CRIAR A TELA DE INSERÇÃO DE EMPRESA 


O primeiro passo é montar a tela para que possamos posteriormente acessar os com- 
ponentes gráficos no código-fonte. Selecione o arquivo Main. storyboardno Pro- 
ject Navigator (Command + 1) e você será apresentado com a tela que corresponde 
àquela que será vista pelo usuário ao rodar o aplicativo. O objetivo aqui é construí-la 
da mesma forma como foi apresentado na figura 3.1 no início do capítulo. 
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PASSOS DETALHADOS 


Ao escrever este livro nos preocupamos bastante para manter um bom 
balanceamento entre mostrar passo a passo como realizar determinadas 
coisas, versus apresentar uma instrução mais curta e direta. Nos capítulos 
iniciais, e especialmente neste em que apresentamos em mais detalhes o 
funcionamento do Xcode e Objective-C, é feito bastante uso de imagens 
para guiar o leitor para determinados menus e botões (além de explicar 
os atalhos de teclado), pois o Xcode utiliza os mesmos painéis para dife- 
rentes tarefas, o que às vezes pode ficar bastante confuso. 











Vamos modificar a cor de fundo da tela principal, colocando um tom de cinza 
claro. Clique em qualquer parte da tela do aplicativo e abra o Attributes Inspector 
(“Inspetor de atributos”) utilizando a tecla de atalho Option + Command + 4, 
ou através do menu View -> Utilities -> Show Attributes Inspector. Veja a figura 3.4 


para referência. 








4 ES CatalogoEm... = B B @ view Controller View 


interaction M User Interaction Enabled 
Multiple Touch 
Alpha 
Background | [TI | White Color 
Tint | EEB | Default 


Drawing M Opaque Hidden 
M Clears Graphics Context 


Clip Subviews 
E a samcaaima Estes dana 





> View Controller - A controller 
Attributes Inspector O that supports the fundamental 


view-management model in... 
Table View Controller - A 
controller that manages a table 
view 


Figura 3.4: Abrir o Attributes Inspector 








Para modificar a cor de fundo clique no item “Background” para abrir a janela 
flutuante “Colors”, e selecione a opção “Color Sliders” na barra superior. Em seguida, 
selecione “RGB Sliders” e insira o valor “250” para os três campos, conforme mostra 
a figura 3.5. Feche a janela “Colors”. 
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View 
= | Mode | Scale To Fill +) 


Tag olg 








Tint | EE | Default +] 

















E | RGB Sliders n 

Red Drawing [M Opaque _] Hidden 

C M Clears Graphics Context 

Green i [| Clip Subviews 

C O EE S E 

= DOSE 

View Controller - A controller 
that supports the fundamental 
view-management model in... 
Table View Controller - A 
controller that manages a table 

Opacity view. 

Di! 100 [06 
Collection View Controller - A 
controller that manages a 

O | collection view. 
[BE |B |e Blja =la] 





Figura 3.5: Modificando a cor de um componente - no caso, a cor de fundo da tela 


3.4 ADICIONAR COMPONENTES VISUAIS 


Abra a Object Library na parte inferior do painel Utilities utilizando a tecla de ata- 
lho CTRL + Option + Command + 3, ou através do menu View -> Utilities -> 
Show Object library, e adicione os seguintes componentes, posicionando-os para que 
fiquem como a figura 3.1, mostrada no início deste capítulo. 


e Label com o texto “Nome da empresa” (dê duplo clique no label, ou então 
preencha a propriedade Text no Attributes Inspector). 


* Um componente Text Field para o usuário digitar o nome da empresa. No 
Attributes Inspector localize a opção Placeholder e digite “ Informe o nome 
da empresa” - um placeholder é um valor padrão que o Text Field irá mostrar 
enquanto o usuário não inserir algum texto. 


e Label com o texto “ Funcionários” 
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Outro componente Text Field, para a quantidade de funcionários. No Attri- 
butes Inspector localize a seção Control e desmarque o checkbox Enabled, pois 
queremos que o usuário modifique o campo utilizando o componente Stepper 
(veja abaixo). No campo Text insira o valor “o”, que será a quantidade inicial 
de funcionários da empresa. 


Um componente Stepper: que será utilizado para aumentar ou diminuir a 


quantidade de funcionários. 


Um botão Button com o texto “ salvar” (propriedade Title, ou duplo clique 
no componente). 


Um componente Label com o texto “Dados salvos com sucesso”, alinhado ao 
centro (propriedade Alignment no Attributes Inspector), e da largura da tela. 
Note que ao modificar o tamanho do componente o Interface Builder mostra 
linhas guia para auxiliar o posicionamento, conforme a figura 3.6. 


São muitos componentes! Pratique os diversos tipos, em especiais os que esta- 


mos utilizando agora. Eles serão necessário na grande maioria das suas aplicações. 


i l =, 

Nome da empresa | 

Funcionários 0: 
Salvar 


Dados salvos com sucesso 


i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
4 
j 
j 
j 
j 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 


Figura 3.6: Guias do Xcode auxiliando no posicionamento e alinhamento dos com- 


ponentes 
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Rode o aplicativo no simulador através da tecla de atalho Command + R, ou 
pelo menu Product -> Run, para ver o resultado até o momento. Se você interagir 
com os elementos verá que não acontecerá muita coisa, pois ainda não conectamos 
os eventos ao código, o que será feito em seguida. 


3.5 ATENÇÃO PARA AS PROPRIEDADES SIMULADAS 


O Attributes Inspector tem uma seção chamada Simulated Metrics, que serve unica- 
mente para simular alguns elementos de interface, para facilitar o posicionamento 
dos componentes em certos tipos de aplicativos. Contudo, tenha em mente que, em- 
bora o uso das propriedades da seção Simulated Metrics resulte em alterações visuais, 
elas são apenas temporárias, não tendo qualquer impacto prático no aplicativo. Veja 
a figura 3.7 para referência. 

Obs: caso você esteja no arquivo Main.storyboard, o box das propriedades 
simuladas somente irão aparecer caso selecione a barra preta na parte inferior da tela 
(aquela que tem três botões, um amarelo, outro laranja e o último verde). Se você 
apenas clicar na “tela” (a parte que em branco que representa o iPhone), o box não 
aparecerá. 
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Elementos simulados 





¥ Simulated Metrics 





Size | None 


Orientation | Portrait 








Status Bar | Gray 
Top Bar | Navigation Bar 


Bottom Bar | Tab Bar 


Mode | Scale To Fill 







Tag 0 E 
Interaction [M User Interaction Enabled 
C Multiple Touch 

Alpha 1 lr 
Background | ETTA: 





Drawing M Opaque [] Hidden 
[] Clears Graphics Context 
C Clip Subviews 


D i|| mw 
| Ia] Objects +) (25) 











Label - A variably sized amount of 
static text. 


Label 





Round Rect Button - Intercepts 
touch events and sends an action 
message to a target object when... 





Segmented Control - Displays 
1 2 | multiple segments, each of which 
functions as a discrete button. 


Figura 3.7: Elementos de interface simulados apenas. Eles não irão aparecer no apli- 


cativo de fato. 


A possibilidade de simular algumas coisas pode ser útil para você construir de 
maneira mais fácil a tela, se em algum momento (muito provavelmente via código) 
pretende inserir os componentes “de verdade”. 


3.6 CONECTANDO OS EVENTOS E COMPONENTES AO CÓ- 
DIGO 


Da mesma maneira que fizemos no capítulo anterior, precisamos conectar os compo- 
nentes gráficos com o código para que seja possível acessá-los de fato — até então, o 
que é feito no arquivo Main. storyboard não tem qualquer relação com código. A 











primeira coisa a fazer é abrir o Assistant Editor (Option + Command + ENTER) 
para visualizar o arquivo ViewController.h ao lado do Main.storyboard. 
Lembre-se que, caso o arquivo exibido seja o ViewController.m (ao invés do “ 
.hº), você deve primeiro alterná-los. 
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ALTERNANDO ENTRE OS ARQUIVOS .H E .M 


É possível alternar rapidamente entre arquivos .he .m relacionados 
utilizando a tecla de atalho CTRL + Command + Seta para cima 
(lembre-se de primeiro clicar na área onde tem algum código), ou então 
clicando no nome do arquivo na barra de navegação, conforme a figura 
3.8. 











Today at 1:07 PM (EEIS| (DO 


sues 
fh] ViewController.h > Ifo Selection 


: UIViewController 





Editor View 









u | 4 > | [Automatic 
#import <UIKit/UIKI 





@interface ViewControl 


S 





@property (retain, natomic) IBOutlet UITextField *nomeField; 
@property (retain, fonatomic) IBOutlet UITextField *quantidadeField; 
@property (retainf nonatomic) IBOutlet UILabel +avisoSucessoLabel; 
- (IBAction)incrfmentadorAlterado: (id)sender; 


Clique para alternar 


Figura 3.8: Alternando entre arquivos utilizando a barra de navegação 








FECHANDO OS PAINÉIS DESNECESSÁRIOS 


É muito fácil deixar diversos painéis abertos no Xcode, aumentando 
bastante a poluição visual e consequentemente diminuindo a área dispo- 
nível para trabalhar, especialmente se você está em uma tela pequena. 
Nesses casos basta esconder o que não for vital, como o Navigator ( 
Command + 0, ou View -> Navigators -> Hide Navigator), o painel de 
Debug (Command + Shift + Y, ou View -> Debug Area -> Hide De- 
bug Area) e o painel Utilities ( Option + Command + 0, ou View -> 
Utilities -> Hide Utilities::) 











A conexão dos componentes deve ser feita da seguinte forma: 
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* Selecione o campo de texto do nome da empresa, segure CTRL e clique e ar- 


raste para o arquivo ViewCont roller .h, posicionando entre Ginterface 
e end. Na janela flutuante que abrir selecione o valor “Outlet” na propriedade 
Connection e insira o o valor “nomeField” na propriedade Name. Isso irá criar 
a variável já com as propriedades corretas. 


Repita o mesmo processo para o campo de texto da quantidade de funcioná- 
rios, colocando como nome o valor “quantidadeField” 


Para o componente Stepper, que é aquele com um botão - e outro +, realize 
o mesmo procedimento de conexão, porém no campo Connection selecione o 
valor “Action” para gerar um método de ação ao invés de criar uma variável 
simples. No campo Name insira o valor “incrementador Alterado”, que será 
o nome do método que será executado toda vez que o usuário interagir com 
o componente, e deixe os outros campos com os valores padrão (Type “ID”, 
Event “Value changed” e Arguments “Sender”) 


Para o botão salvar, crie a Connection do tipo “Action”, com o Name “salvar”, e 
o aceite o valor padrão do resto dos campos 


Por último, conecte o label que tem o texto “Dados salvos com sucesso” cri- 
ando uma Connection do tipo “Outlet” e o Name “avisoSucessoLabel” 


Neste ponto o arquivo ViewController.h deverá estar como o código abaixo: 


# import <UIKit /UIKit.h> 


Ointerface ViewController : UlViewController 


@property (weak, nonatomic) IBQutlet UlTextField *nomeField; 


Oproperty (weak, nonatomic) IBQutlet UlTextField *quantidadeField; 


OGproperty (weak, nonatomic) IBQutlet UlLabel *avisoSucessoLabel; 


- (IBAction) incrementadorAlterado: (id)sender; 


- (IBAction)salvar: (id)sender; 


Gend 


Se você abrir o arquivo ViewController.m verá que o Xcode já criou para a 


gente o corpo dos métodos incrementadorAlterado: e salvar:. 
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O QUE EXATAMENTE É IBÔUTLET E IBACTION? 


Os modificadores IBOutlet e IBAction são usados unicamente 
como marcadores para integrar componentes do Interface Builder com 
o código-fonte em arquivos .h. O primeiro é usado quando queremos 
referenciar o componente no código através de uma variável, e o segundo 
é usado exclusivamente para ações dos componentes, como o toque em 
um botão. Por trás dos panos, o que o Xcode faz é analisar o código e 
automaticamente realizar as devidas conexões entre a interface gráfica e 


o nosso código. 











3.7 UMA CLASSE PARA REPRESENTAR UMA EMPRESA 


Agora que já temos a tela criada, é hora de colocar a mão no código, e o primeiro 





passo é criar a classe Empresa para armazenar as informações preenchidas pelo 
usuário. Para isso, abra a janela de adição de arquivos ( Command + N, ou então 
File -> New -> File...), e selecione o template Objective-C class. Clique no botão Next, 
insira o valor “Empresa” no campo Class, e em Subclass of selecione o item “NSObject”. 
Clique em Next:: para salvar o arquivo. 





IMPORTANTE 


Ao incluir arquivos em qualquer projeto que for trabalhar, certifique- 
se de que a opção Targets esteja selecionada na caixa de diálogo de salvar 
arquivo conforme mostra a figura 3.9. Isso é necessário para associar o 
arquivo com o projeto — do contrário, o Xcode ignorá-lo-ia na hora de 
compilar e empacotar o projeto para distribuição. 
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Casa do Código 








| «4 £ CatalogoEmpresas 











E» CatalogoEmpresas - h) AppDelegate.t 


> talogoE xcodepro | AppD 


FAVORITES 


(5) rafael 





x Applications h 


(al 


Catalogo 

ul Desktop en.lproj 
m Documents 
© Downloads , ' mi View 
E projects 

II 

£ Dropbox 
DEVICES 

i Mac 





Group | [7] CatalogoEmpresas 





Targets M sh: CatalogoEmpresas 


Cancel 


| Create | 


New Folder 


Figura 3.9: Target corretamente selecionado 





ALTERNANDO NOVAMENTE ENTRE OS PAINÉIS 
Trabalhar no Xcode é um processo constante entre esconder, 


que nossa produtividade aumente. No caso desta seção, onde já 


ENT 





ER, € 





dard Editor utilizando a tecla de atalho Command + 





o outro painel com o atalho Option + Command + 0,esel 
arquivo ViewController.mno Navigator (Command + 1) 





e mudar o tipo dos painéis de acordo com a tarefa a ser feita, de modo 


a tela e vamos focar mais em código, não é necessário manter o arquivo 
Main.storyboard aberto e nem o painel Utilities. Alterne para o Stan- 


mostrar 


criamos 


esconda 
ecione o 








A nossa empresa tem duas propriedades: nome (uma string) e quantidade de 





funcionários (número inteiro). Abra o arquivo | 


como o código abaixo: 


1 Zimport <Foundation /Foundation.h> 


2 
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Qinterface Empresa : NSObject 


@property (nonatomic, retain) NSString *nome; 
@property (nonatomic, assign) int quantidadeFuncionarios; 


@end 





Não é necessário fazer qualquer modificação no arquivo “ Empresa . m”. 


3.8 CABEÇALHOS E IMPLEMENTAÇÕES 


Em Objective-C, a declaração e implementação da classe ficam em arquivos diferen- 
tes. A declaração, ou — usando o termo correto — interface, fica em um arquivo 
com a extensão .h, de header (cabeçalho), enquanto que a implementação fica em 
um arquivo com a extensão .m. Diferentemente de outras linguagens, nas quais se 
usa apenas um arquivo para tudo o que diz respeito à classe, em Objective-C você 
sempre precisará da dupla .he .m. 





No arquivo de cabeçalho (como o Empresa .h) fica a declaração da classe, das 
variáveis de instância, das propriedades, dos métodos de instância e dos métodos de 
classe. 





NOTA SOBRE (INTERFACE 


A declaração Ginterface é semanticamente muito diferente da 
mesma palavra-chave no Java e C#, em que representa um determi- 
nado contrato que a classe deve seguir. Em Objective-C, Ginterface 
serve unicamente para declarar a classe, e o equivalente da palavra chave 
interface do Java e do C# é Eprotocol, que veremos em um outro 
capítulo. 











Enquanto o cabeçalho define apenas a estrutura geral da classe, e não o có- 
digo propriamente dito, o arquivo .m contém o “código de verdade”, como arquivo 





ViewController.mou Empresa.m. 
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CURIOSIDADE SOBRE A EXTENSÃO .M 


A extensão .m do Objective-C originou-se a partir de “mensagens” 
(do termo em inglês messages), a qual se refere a um dos principais con- 
ceitos da linguagem. 











3.9 INFORMANDO A QUANTIDADE DE FUNCIONÁRIOS 


Estamos na metade do caminho, mas o resto é só código! Agora que temos a tela e a 
classe Empresa vamos colocar as ações nos métodos de incrementar a quantidade 





de funcionários e salvar a empresa em si. Como visto na figura 3.1 a tela contêm 
dois componentes que devem trabalhar em conjunto para alterar a quantidade de 
funcionarios: um campo de texto (UI TextField) e um incrementador (UlIStepper). O 
que queremos que aconteça é que quando o usuário tocar em algum dos botões, o 
valor correspondente apareça no UlTextField ao lado. 

No arquivo ViewController.h criamos uma  IBAction chamada 
incrementadorAlterado:, que é o método a implementar. Abra o arquivo 


ViewController.me faça o seguinte: 


- (IBAction) incrementadorAlterado: (id)sender { 
UlStepper *incrementador = (UIStepper *)sender; 
self.quantidadeField.text = [NSString stringhithFormat:O"yd", 
(int) incrementador.value]; 


O método incrementadorAlterado: segue um padrão bastante comum em 
Objective-C, que é o de receber um argumento do tipo id chamado sender quando 
for associado a algum evento. No caso, id pode ser lido como “qualquer coisa”, e 
sender (“remetente, “quem enviou”) é apenas o nome da variável — você pode 
modificar para o que achar mais apropriado, apesar de este ser o nome utilizado 
em toda documentação. Levando isso em consideração, na linha 2 convertemos 
sender para o tipo UIStepper, pois sabemos que este método será chamado ape- 
nas quando o UIStepper da tela for modificado. Já nas linhas 3 e 4 convertemos 
para string o valor numérico do componente existente na propriedade value, pois 
O UlTextField não aceita números diretamente. 

Rode o aplicativo através do atalho Command + Rou através do menu Product 
-> Run e clique nos botões - e +, para ver o campo de texto receber os valores. 
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3.10 TRABALHE COM OBJETOS: INSTANCIANDO UMA EM- 
PRESA 





Para criar uma nova empresa precisamos de instâncias da classe Empresa e preen- 
cher as propriedades nome e quantidadeFuncionarios. Isso será feito na ação 
do botão “Salvar”, conforme mostrando no código abaixo: 


- (IBAction)salvar: (id)sender { 
Empresa *e = [[Empresa alloc] init]; 
e.nome = self.nomeField.text; 
e.quantidadeFuncionarios = [self.quantidadeField.text intValue]; 


NSLog(0"Empresa criada. Nome=h0, funcionários=kd", 
e.nome, e.quantidadeFuncionarios); 





Na linha 2 criamos uma nova instância da classe Empresa, enquanto que 
nas linhas 3 e 4 preenchemos as propriedades com os valores dos componentes da 
tela. Estas são aquelas mesmas variáveis com property existentes no arquivo 





Empresa .h. Nas linhas 6 e 7 escrevemos os valores no console para fins de debug- 
ging. 
Compile o projeto com o atalho Command + B. Funcionou? A menos 





que você tenha importado o arquivo Empresa.h logo no início do arquivo 
ViewController.m,o Xcode deverá ter acusado erros de compilação informando 





que a classe Empresa não existe. Para resolver este problema, adicione a linha 





timport "Empresa.h" no topo do arquivo ViewController.m, recompile o 
projeto e rode-o com Command + R. 


O painel de debug e console do Xcode 


Rode o aplicativo, insira o nome e quantidade de funcionários e clique no botão 
salvar. O Xcode deverá mostrar automaticamente uma mensagem de log no painel 
inferior (caso contrário, abra-o através do atalho Command + Shift + C,oupelo 
menu View -> Debug Area -> Activate Console), conforme a figura 3.10. Como você 
já associou, a função NSLog serve para jogar informações no console do Xcode, 
o que é útil em diversos momentos durante o ciclo de desenvolvimento e testes do 
aplicativo. 
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013-12-08 04:19:26.000 CatalogoEmpresas[3060:70b] Empresa criada. Nome=teste, funcionários=3 





Figura 3.10: Localização do console de debug com saída do NSLog 


3.11 COMO SÃO AS STRINGS EM OBJECTIVE-C? 


Strings em Objective-C são representadas pela classe NSSt ring, e seus valores de- 
vem ser precedidos pelo caractere @ (arroba). Isso é necessário para se distinguir do 
array de caracteres da linguagem C (tecnicamente, instruções como char x), na 
qual Objective-C é fundamentada. 


A forma correta de criar strings em Objective-C é mostrada abaixo: 


// OK - utiliza '@' 
NSString *nome = @"Rafael Steil"; 
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// ERRO - o código abaixo não irá funcionar 
NSString *ops = "0bjC não funciona assim"; 
3.12 FORMATANDO STRINGS 


É possível construir strings utilizando alguns caracteres especiais de formatação atra- 
vés do método stringWithFormat :, conforme mostrado abaixo: 


double faturamento 1234.567; 


NSString *mensagem = [NSString stringWithFormat: 
@"A empresa 40 tem hd funcionários, e faturamento de R$ %f", 
e.nome, e.quantidadeFuncionarios, faturamento]; 


A lista de formatadores é relativamente extensa, porém os mais comuns são: 
e 3@ : para qualquer tipo de objeto, incluindo outras NSStrings 

e “ad : números inteiros (int e unsigned int) 

e šf : números de ponto flutuante ( float e double) 


A função NSLog já aceita por definição esta mesma estrutura de formatação, 
sem ser necessário a utilização de stringWithFormat:. 


3.13 GUARDANDO TODAS EMPRESAS EM MEMÓRIA 


O código que fizemos até agora cria a empresa, mas não a armazena em nenhum 
lugar, porém nós queremos manter uma relação de todos os registros que foram in- 
seridos e mostrar no console a relação completa a cada nova empresa. Existe uma 
infinidade de maneiras de realizar esta tarefa, e para o propósito deste capítulo — 
que é apresentar em maiores detalhes o Xcode e a linguagem Objective-C — vamos 
nos concentrar em algo simples e prático, como uma lista em memória, utilizando a 
classe NSArray. 





NSARRAY VERSUS ARRAY 


Apesar de conter a palavra “array” no nome, tecnicamente a classe 
NSArray não é um array no conceito formal da linguagem, mas sim se 
equivale muito mais a uma lista, algo como a classe ArrayList de Java 
e Cx. 
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A primeira coisa a fazer é ir para o arquivo ViewController.h (tecla de ata- 
lho CTRL + Command + Seta para cima) e declarar uma variável chamada 
catalogo do tipo NSMutableArray, conforme exemplificado abaixo: 


1 #import <UIKit /UIKit.h> 

3 Ginterface ViewController : UlViewController { // Abre chave aqui 
4 NSMutableArray *catalogo; 

s } // Fecha chave aqui 

6 

7 // Este código abaixo já havia sido feito anteriormente 

s Gproperty (weak, nonatomic) IBQutlet UlTextField *nomeField; 

o Oproperty (weak, nonatomic) IBQutlet UlTextField *quantidadeField; 
1 Oproperty (weak, nonatomic) IBQutlet UlLabel *avisoSucessoLabel; 
u - (IBAction) incrementadorAlterado: (id)sender; 

» - (IBAction)salvar: (id)sender; 


14 Gend 


O código referente a esta seção é o da linha 4, lembrando que é necessário 
adicioná-lo entre chaves (final da linha 3 e linha 5), como foi explicado anterior- 
mente na seção da classe Empresa. Da linha 8 em diante é o código que criamos 





anteriormente, e foi adicionado na listagem apenas para referência. 

Voltando o arquivo ViewController.m (lembra da tecla de atalho?), vamos 
criar o método para armazenar as empresas no objeto catalogo, e depois chamar o 
método na ação do botão “Salvar”. Adicione o seguinte código logo antes do método 


— (IBAction) salvar: (id) sender 





1 - (void) salvaEmpresa: (Empresa *) novaEmpresa { 


2 if (!catalogo) { 

3 catalogo = [[NSMutableArray alloc] init]; 
4 } 

5 

6 [catalogo add0bject :novaEmpresa] ; 

7} 





Na linha 6 adicionamos na lista o objeto novaEmpresa passado como argu- 
mento ao método. Já as linhas 2 e 3 precisam de uma explicação mais detalhada: em 
Objective-C objetos não-instanciados contêm por padrão o valor nil (que é um 
primo próximo do NULL de Java, C# e do próprio C e C++). Além disso, na lingua- 
gem os valores nile 0 (zero) são tratados como “falso” em expressões condicionais, 
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da mesma forma que qualquer coisa que não seja ni1 ou 0 é considerada como “ver- 
dadeiro” em condicionais booleanas. Em outras palavras, os seguintes códigos são 
equivalentes: 


// OK 
if (Icatalogo) 1 


// OK - mesmo efeito do exemplo anterior 
if (catalogo == nil) 1 


Por fim, na linha 3 criamos uma nova instância de fato do NSMutableArray 





NSARRAY VERSUS NSMUTABLEARRAY - IMUTÁVEL E MUTÁVEL 


Algumas classes do SDK do iOS contêm versões imutáveis (que após 
criadas não podem mais ser modificadas) e versões mutáveis (que po- 
dem ser modificadas livremente), como é o caso do NSArray (imutá- 
vel)e NSMutableArray (mutável). Saber quando usar uma versão ou 
outra depende exclusivamente das necessidades de cada parte do código. 
Outras classes imutáveis que têm versões mutáveis são NSDictionary, 
NSSet, NSData e NSString 











3.14 LISTANDO TODAS AS EMPRESAS DO CATÁLOGO 


Aproveitando que estamos embalados, vamos criar também um outro método que 
lista todas as empresas adicionadas ao catalogo. Adicione o seguinte código logo 





após o método salvaEmpresa 
- (void) mostraCatalogo ( 


NSLog(0"+++++++* Listando todas empresas **kkk**"); 


for (Empresa *empresa in catalogo) { 
NSLog(0"A empresa KO tem hd funcionários", 
empresa.nome, empresa.quantidadeFuncionarios); 
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Modifique o método salvar: para remover a antiga chamada a NSLog, e in- 
voque os dois novos métodos que criamos. Confira abaixo: 


- (IBAction)salvar: (id)sender { 
Empresa *e = [ [Empresa alloc] init]; 
e.nome = self .nomeField.text; 
e.quantidadeFuncionarios = [self.quantidadeField.text intValue]; 


[self salvaEmpresa:e]; 
[self mostraCatalogo]; 


Rode novamente o aplicativo no simulador através da tecla de atalho Command 
+ R (ou pelo menu... você ainda lembra qual é?) e insira algumas empresas, para ver 
o resultado do aplicativo até o momento. 


3.15 VENÇA A SINTAXE DO OBJECTIVE-C: INVOCAÇÃO DE 
MÉTODOS 


A assinatura de métodos em Objective-C é algo bastante particular da linguagem, e 
pode ser um pouco criptográfico numa primeira olhada. Uma das intenções dos cri- 
adores da linguagem foi criar uma sintaxe declarativa e fácil de ler, que não deixasse 
margem para dúvidas em relação ao que se refere cada valor passado ao método. Se 
isso é algo bom ou ruim, cabe a você decidir. 


Considere o seguinte código, retirado da classe NSMutableArray: 


- (void) insertObject: (id) objeto atIndex: (NSInteger) indice; 


A declaração do método começa com o tipo de acesso, seguido do tipo de retorno 
e do nome do método. Se o método começa com o sinal de soma ( +) significa que ele 
é um método de classe (que é algo próximo ao static do Java e C&), e se começar 
com o sinal de subtração ( —), é um método de instância. Veremos mais sobre isso 
no capítulo sobre Objective-C avançado. O retorno pode ser qualquer tipo válido de 
Objective-C ou C, como int, float, id, NSInteger, void etc. 

Para passar um argumento para o método é bastante simples, bastando utilizar o 
sinal de dois pontos (“:”) para separar o nome do método da variável. Por exemplo, 
o código abaixo insere uma empresa em uma posição específica: 


[catalogo insertObject:empresa atIndex:3]; 
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Toda invocação de método precisa ser feita entre colchetes, aninhando-os con- 
forme necessário (ou seja, colchete dentro de colchete dentro de colchete). Sim, o 
código fica um pouco difícil de ler, em especial enquanto você está aprendendo mais 
da linguagem. 

Já um método que recebe múltiplos argumentos pode assustar um pouco mais 
(pelo menos assustou a mim, por semanas), porém compreender sua estrutura é 
fundamental. Considere o seguinte método, também de NSMutableArray, que 
serve para substituir uma parte dos elementos com objetos de outro NsArray: 


- (void)replace0bjectsInRange: (NSRange) range 
with0bjectsFromArray: (NSArray *) outroArray 
range: (NSRange) rangeDoDQutroArray 


Para efeitos de comparação, o mesmo método em Java seria declarado parecido 


com isso:: 


void replace0bjectsInRange (NSRange range, NSArray outroArray, 
NSRange rangeDol0utroArray); 


Para visualizar melhor a formação da assinatura do método, veja a figura 3.11 


- (void) replaceObjectslnRange:(NSRange) range 
withObjectsFromaArray:(NSArray *JoutroArray 
range:(NSRange) outroRange 


Utilizados dentro do método 


Figura 3.11: Estrutura da assinatura de um método em Objective-C 


Note que, embora assustador em um primeiro momento, o padrão de construção 
para os demais argumentos se repete, sendo formado sempre por 3 partes: a palavra 
que fará parte do nome do método, o tipo da variável e o nome da variável em si. 
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É esta última que será utilizada dentro do método. Muitas vezes, a palavra que faz 
parte do nome do método e a variável costumam ser iguais, mas isso não é uma regra. 

A nomenclatura irá variar de acordo com cada caso, sendo que o mais importante 
é que você utilize nomes que façam sentido ao contexto de uso. Considere o exemplo 
abaixo, de um método que recebe o nome e quantidade de funcionários de uma 
empresa, e retorna uma instância da classe: 


- (Empresa *) criaEmpresaComNome: (NSString *) nome 
comNumeroDeFuncionarios: (int) quantidade { 


Empresa *e = [ [Empresa alloc] init]; 
e.nome = nome; 
e.quantidadeFuncionarios = quantidade; 
return e; 


Para invocar, fazemos: 


Empresa *novaEmpresa = [self criaEmpresaComNome:0"Jujubas LTDA" 
comNumeroDeFuncionarios:3]; 


A verbosidade do nome dos métodos tem um motivo especial, que é fazer com 
que o código seja fácil de ler e expresse bem o domínio no qual é aplicado. 


3.16 CRIANDO INSTÂNCIAS DE OBJETOS 


Para poder criar instâncias de classes em Objective-C são necessários dois passos: 
alocar memória, e iniciar o objeto. Estes passos geralmente são feitos em conjunto, e 
o objeto somente poderá ser utilizado depois que estes dois passos tiverem sido com- 
pletados com sucesso. Também não existe o conceito de construtores propriamente 
ditos, mas sim de inicializadores, que por padrão chama-se init. Veja o código 
abaixo: 


Empresa *e = [[Empresa alloc] init]; 


A primeira parte do processo de instanciação ocorre com o método alloc, 
o qual reserva memória necessária para todas as variáveis de instância e as inicia 
com os valores padrão. Em seguida, o método init prepara a instância de fato, 
permitindo que seja utilizada. O método init retorna um tipo id, que é como 
um “ponteiro para qualquer objeto”; pense nele como sendo um primo do Object 


46 


Casa do Código Capítulo 3. Mais Objective-C e Xcode 





de Java e C&, contudo muito mais abrangente (existe o tipo NSObject, porém). 
init é disponibilizado por padrão, não sendo necessário que você implemente-o 
toda vez. Entretanto, caso queira fazer uma rotina de inicialização do objeto, basta 
sobrescrevê-lo: 


-(id) init { 
self = [super init]; 


if (self) { 
// Se chegou aqui, a inicialização ocorreu com sucesso 


return self; 


A linha 2 invoca o método init na classe-pai (que será pelo menos NSObject), 
enquanto a linha 4 verifica se o processo ocorreu com sucesso. Caso tenha falhado, 
self irá conter o valor nil. 

É possível criar inicializadores customizados, exatamente como faríamos como 
qualquer outro método, prestando atenção apenas na necessidade de chamar algum 
outro inicializador da classe-pai (ou um outro na mesma classe, que eventualmente 
chame o da classe-pai). Por exemplo, poderíamos criar um inicializador para a classe 
Empresa que já recebe o nome e a quantidade de funcionários: 





- (id) initWithNome: (NSString *) nome eQuantidadeFuncionarios: (int) 
quantidade 1 
if ((self = [super init])) 1 
self .nome = nome; 
self.quantidadeFuncionarios = quantidade; 


return self; 


Para criar uma nova instância: 


Empresa *ep = [ [Empresa alloc] initiWlithNome:0"Jujubas LTDA" 
eQuantidadeFuncionarios:17]; 
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3.17 MELHORIA: ESCONDER O TECLADO AUTOMATICA- 
MENTE 


Um problema com o nosso aplicativo é que, uma vez que o teclado aparece, ele nunca 
mais some, nem mesmo após salvarmos a empresa. Além disso, a imagem de su- 
cesso fica escondida. Isso ocorre porque em iOS não existe exatamente o conceito de 
“foco” nos componentes como temos em aplicações tradicionais ou mesmo na Web, 
mas sim algo chamado de responder, que são objetos que podem lidar com diversos 
tipos de eventos. No caso de componentes como o UlTextField que utilizamos 
no aplicativo deste capítulo, eles aceitam as mensagens de entrada de texto (que dis- 
param o teclado), porém outros componentes como botões (o UlButton no nosso 
caso) ignoram tais eventos. Então, o componente que inicialmente pegou o teclado 
fica com ele até que outro componente o peça ou, então, que explicitamente recebam 
uma mensagem para liberá-lo. E é isso o que faremos. 





A CADEIA DE EVENTOS 


Tecnicamente os motivos são um pouco mais densos, e na explicação 
desta seção optamos por apresentar de uma forma mais curta e simples 
para não sair do foco do capítulo. Para saber mais a respeito, procure por 
“UIResponder Chain” na Internet. 











No método salvar: adicione uma chamada ao método 
resignFirstResponder do componente de nome da empresa, conforme o 


código abaixo: 


- (IBAction)salvar: (id)sender { 
// Libera o teclado 
[self .nomeField resignFirstResponder] ; 


// Restante do método 


O código da linha três diz algo como “eu me abstenho de responder pelos eventos 
por enquanto”, fazendo com que o teclado desapareça. Se quiser forçar o teclado a 
aparecer, basta usar o método becomeFirstResponder. 
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3.18 MELHORIA: MOSTRANDO A MENSAGEM DE SUCESSO 
SOMENTE AO SALVAR 


Até o momento a mensagem “Dados salvos com sucesso” aparece o tempo todo, 
quando na prática deveria aparecer após adicionarmos uma nova empresa, e ainda 
assim apenas por alguns momentos. Para solucionar isso primeiro precisamos 


escondê-la ao iniciar o aplicativo, e mostrá-la na ação do botão “Salvar”. 





Para a primeira primeira parte, atribua o valor YES à propriedade hidden da 
variável avisoSucessoLabel, isso tudo no método viewDidLoad do arquivo 


ViewController.m, conforme o código abaixo: 


- (void)viewDidLoad { 
[super viewDidLoad]; 
self .avisoSucessoLabel .hidden = YES; 


Em tempo: todo componente tem a propriedade hidden. Para a segunda parte 
— mostrar a mensagem por alguns instantes — vamos novamente modificar o mé- 
todo salvar:. Adicione o código abaixo ao final do método: 


- (IBAction)salvar: (id)sender { 
// Código já existente omitido apenas no livro 


self .avisoSucessoLabel.alpha = 0; 


[UIView animateWithDuration:1 animations:"( 
self .avisoSucessoLabel .hidden = NO; 
self .avisoSucessoLabel .alpha = 1; 
+ completion:” (BOOL finalizado) { 
[UIView animateWithDuration:1 delay:2 options:0 animations: ( 
self .avisoSucessoLabel.alpha = 0; 
+ completion:”(BOOL finalizado) { 
self .avisoSucessoLabel .hidden = YES; 
H; 
H; 


Se você se assustou com este último pedaço de código, não se preocupe: você 
não é o único. Objective-C pode ser um tanto amedrontador em certos momentos. 
Além disso, o código ficou um pouco maior porque estamos fazendo duas anima- 
ções: a primeira para mostrar o aviso, e a segunda para escondê-la novamente após 
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um certo tempo. Mais adiante, no capítulo sobre UIViews mostraremos a fundo 
o funcionamento dos blocos de animação, que são um recurso mais avançado da 
linguagem. 





CRIAÇÃO DO BLOCO DE ANIMAÇÃO 


Repare que o bloco de animação criado na última listagem de código 
utiliza o caracter circunflexo ( ^) para indicar o início de um pedaço de 
código. Em alguns teclados é necessário apertar a tecla que contêm este 
símbolo, seguido da barra de espaço. 











Rode o aplicativo, insira uma empresa, e você verá a mensagem aparecendo de 
maneira animada, e depois de 2 segundos tornando a desaparecer automaticamente. 
Você está ficando bom nisso! 
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Coordenando o trabalho com 
controladores 


Diferentes plataformas contêm diferentes maneiras de resolver uma necessidade bas- 
tante comum, que é a de gerenciar diversas telas e funcionalidades. Além disso, é 
necessário que a navegação e transição entre elas sejam uma tarefa intuitiva para o 
usuário e lógica para o desenvolvedor. Em aplicativos iOS isso é feito com o uso de 
controladores (controllers), que são classes que — como o próprio nome sugere — 
controlam (ou gerenciam) um conjunto de funcionalidades diretamente relaciona- 
das. 

Controladores (do inglês “controllers”) são classes normais, e portanto podem 
conter qualquer tipo de lógica e regra de negócios, embora — ao menos teorica- 
mente — o ideal é que sejam usados como um intermediário, como um facilitador 
de trabalho entre a camada visual (as views) e a lógica de negócios. Na prática, mui- 
tos desenvolvedores acabam misturando as coisas em um único lugar, o que pode 
levar a dificuldades para manter e evoluir o aplicativo a longo prazo. 


Casa do Código 





O código-fonte deste capítulo está disponível nas pastas “ViewController Ani- 
mations” e “NavigationControllerDemo” (lembrando que o endereço do site com os 
códigos está na introdução do livro). 

O objetivo deste capítulo é mostrar diferentes maneiras de interagir entre View 
Controllers, que são as classes responsáveis por coordenar o trabalho em aplica- 
ções iOS, tais como redimensionamento de views, eventos de rotação do dispositivo 
e navegação entre as diversas partes do aplicativo. A figura 4.1 mostra o papel de um 
controlador frente a diversas outras partes de um aplicativo. 


t 


Navigation item 


Custom view 
view controller 

















Tab bar item 


Custom 
data objects 


Figura 4.1: Papel do controlador. Fonte: Apple 


Controladores por si só não são componentes visuais. Pense neles como um es- 
queleto, que embora não possa ser visto, é vital para que tudo se encaixe. A interface 
com o usuário é feita através de views, tanto que ele tem a sua própria propriedade 
chamada view. 
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CONTROLADORES E STORYBOARDS 


Todo o conteúdo apresentado neste capítulo é fundamental para o 
correto entendimento de um dos principais pilares de aplicações iOS, e 
tem direta ligação com o conteúdo do próximo capítulo, 5. 











4.1 PASSANDO DE UM CONTROLADOR PARA OUTRO 


Existem diversas formas de fazer a transição entre controladores, como apresentá- 
los de forma modal, ou então utilizando um navegador especializado. Veremos essas 
duas abordagens neste capítulo. 

Controladores do tipo Modal funcionam da mesma maneira como janelas mo- 
dais em aplicativos desktop, que é aquele comportamento no qual, quando um com- 
ponente desses é apresentado, nada do componente anterior pode ser acessado en- 
quanto este não for fechado. 

Crie um novo projeto do tipo Single View Application (File -> New -> Pro- 
ject -> Single View Application) chamado “ viewControllerAnimations” e 
selecione iPhone como Device. O Xcode irá criar um projeto com os arquivos 
AppDelegate.me .h, e outra classe chamada ViewController.me .h, além 
do arquivo Main. storyboard. 

Abra o arquivo Main.storyboard, e adicione quatro componentes do tipo 
Button, com os textos “Dissolver”, “Virar página”, “Subir vertical” e “Girar horizontal” 
— estas serão as operações que realizaremos. 
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Sutton | item on a UlToolbar or 
UlNavigationitem object. 


Fixed Space Bar Button Item - 
fesesese=s] Represents a fixed space item on a 
UlToolbar object. 


Figura 4.2: Localização do Round Rect Button, no Xcode 


A tela deverá ficar como a da figura 4.3. 


54 


Casa do Código Capítulo 4. Coordenando o trabalho com controladores 





= | 


Dissolver 


Virar página 


Subir vertical 


Girar horizontal 











Figura 4.3: Tela com os botões posicionados 


O próximo passo é conectar as ações destes botões. Abra o Assistant Editor ( 
View -> Assistant Editor -> Show Assistant Editor,ou Option + 





Command + Enter), e conecte uma ação para cada um dos botões no arquivo “ 
ViewController.h” da seguinte forma: 


e Texto: “Dissolver”, nome do método: “showDissolve” 
* Texto: “Virar página” método: “showPageCurl 
e Texto: “Subir vertical”, método: “showVertical” 


e Texto: “Girar horizontal”, método: “showHorizontal” 


O código do arquivo ViewCont roller .h deverá estar como mostrado abaixo: 
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t import <UIKit /UIKit.h> 


Ginterface ViewController : UlViewController 
- (IBAction)showDissolve: (id)sender; 

- (IBAction)showPageCurl: (id)sender; 

- (IBAction)showVertical: (id)sender; 

- (IBAction)showHorizontal: (id)sender; 

Gend 


Cada um dos métodos que iremos implementar terá como tarefa mostrar ou- 
tro controlador ao usuário, sobrepondo o principal temporariamente. A forma que 
veremos é uma das várias possíveis maneiras, e mais adiante será mostrado como 
utilizar a classe UlLNavigationController para fazer a navegação entre eles de 
maneira organizada e gerenciável. 


Para que os botões possam abrir um novo controlador é necessário primeiro criá- 





los. Para tanto, acesse o menu File -> New -> File... eselecione o template 
Objective-C class, e clique no botão Next. Na próxima tela devemos informar o nome 
da classe a ser criada, e qual será a classe pai. Chame-a de “OpcoesController”, e em 
“Subclass of” selecione a opção “UIViewController” Marque também o checkbox 
“With XIB for user interface”, conforme mostrado na figura 4.4. 
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Choose options for your new file: 





Class | OpcoesController 


Subclass of |UlViewController x 





[_] Targeted for iPad 
M With XIB for user interface 














| Cancel | | Previous | [Next | 


Figura 4.4: Criando o controlador para a tela de opções 


Quando o Xcode perguntar onde o arquivo deverá ser salvo, selecione a pasta 
raiz do projeto, no mesmo lugar onde estão os outros arquivos. Você deverá ter o 
arquivo “OpcoesController” nas extensões “h”, “m” e “xib”. 

Reparem bem que todos os arquivos têm o mesmo nome, mudando a extensão. 
Embora não seja obrigatório nomear deste jeito, esta é a maneira que todos os de- 
senvolvedores costumam utilizar. Além disso, quando trabalhamos com interfaces 
gráficas utilizando arquivos .xib, respeitar a convenção de nomes simplifica o có- 
digo, pois o comportamento padrão do iOS é procurar o .xib que tenha o mesmo 
nome da classe. 

Abra o arquivo “OpcoesController.xib”e adicione um componente do tipo 
“Label” no meio da tela, com o texto “Opções” apenas para termos uma indicação 
visual quando ele for exibido. 

Agora vá ao arquivo ViewController.m, onde você irá encontrar o corpo 
dos métodos que foram conectados anteriormente (pelo Main.storyboard) ao 
arquivo ViewController.h. Cabe a nós implementar cada uma das ações dos 
botões. O primeiro método éo showVertical, que representa a animação padrão 
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do iOS para o tipo de operação que iremos realizar. O que deve ser feito é criar 
uma instância do OpcoesCont roller, especificar o tipo da animação e invocar o 
método presentModalViewController. 

Vamos primeiro ver a implementação completa do método, conforme a listagem 
abaixo: 


- (IBAction)showVertical: (id)sender { 
OpcoesController *c = [[OpcoesController alloc] init]; 
c.modalTransitionStyle = UlModalTransitionStyleCoverVertical; 


[self presentViewController:c animated:YES completion:nil]; 








Obs: não esqueça de adicionar a instrução import 








"OpcoesController.h" no início do arquivo. 


Na linha 3 é definido o tipo de animação desejado, que no caso é 





UIModalTransitionStyleCoverVertical. Esta é a animação padrão, e po- 
demos omitir isso na prática. Porém, como neste caso desejamos testar todas as 
animações possíveis, é interessante atribuirmos explicitamente o tipo desejado. 

Já a linha 5 é a responsável por mostrar de fato o nome controller ao usuário, 
através do método presentViewController:animated:completion 

Rode o aplicativo ( Command+R) e clique no botão “Subir vertical”. Você deverá 
vero OpcoesController cobrir toda a tela, vindo de baixo para cima. Esta foi a 
primeira animação. O próximo método a implementar éo showHorizontal, que 
mostrará utilizando um efeito de girar a tela horizontalmente. A implementação 
completa está abaixo: 


- (IBAction)showHorizontal: (id)sender { 
OpcoesController *c = [[OpcoesController alloc] init]; 
c.modalTransitionStyle = UlModalTransitionStyleFlipHorizontal; 


[self presentViewController:c animated:YES completion:nil]; 


Rode novamente o aplicativo e clique no botão “Girar horizontal”, e veja a dife- 
rença no efeito da animação. Bacana, não? 

Repare bem na implementação dos métodos showvertical e 
showHorizontal, e veja que a maior parte do código deles é igual, mu- 
dando apenas o tipo de animação desejada. Como temos mais duas animações 
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para implementar, o ideal seria isolar o código em comum a todos os métodos e 
centralizá-lo em um único lugar, evitando assim a duplicação de trabalho. Embora 
estejamos fazendo apenas um aplicativo de testes, quanto mais cedo adotar a prática 
de reutilizar código, mais rapidamente ela se tornará natural, e consequentemente o 
seu sistema ficará mais fácil de manter. 

Portanto, antes de implementar os demais métodos, vamos primeiro criar um 
método que fará todo o trabalho repetitivo, recebendo como parâmetro o tipo de 
animação a ser utilizada. Veja a implementação completa abaixo: 


- (void) mostraControllerComAnimacao: (UIModalTransitionStyle) estilo { 
OpcoesController *c = [[OpcoesController alloc] init]; 
c.modalTransitionStyle = estilo; 


[self presentViewController:c animated: YES completion:nil]; 


O método mostraControllerComAnimacao: é praticamente igual ao có- 
digo que fizemos anteriormente, com a diferença de que ele recebe um argumento 
especificando o tipo de animação. Coloque a implementação dele em qualquer lugar 
da classe (por exemplo, logo abaixo de implementation), e implemente o resto 


dos métodos da seguinte maneira: 


(IBAction)showDissolve: (id)sender { 
[self 
mostraControllerComAnimacao:UIModalTransitionStyleCrossDissolve]; 


- (IBAction)showPageCurl: (id)sender { 
[self 
mostraControllerComAnimacao:UIModalTransitionStylePartialCurl]; 


- (IBAction)showVertical: (id)sender { 
[self 
ostraControllerComAnimacao:UIModalTransitionStyleCoverVertical]; 


(IBAction)showHorizontal: (id)sender 1 
[self 
mostraControllerComAnimacao:UIModalTransitionStyleFlipHorizontal]; 
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Bem mais simples e prático, e sem duplicar código. Rode novamente o aplicativo 
e teste cada um dos botões. 


4.2 FECHAR UM CONTROLADOR MODAL 


Uma coisa que você deve ter notado é que, depois de abir um controlador usando 
presentViewController, não havia nenhuma maneira de fechá-lo ou voltar 
para a tela anterior. Contudo, isso é bastante simples de se resolver através do mé- 
todo dismissViewControllerAnimated:completion, que deve ser adicio- 
nado como ação de um botão na classe OpcoesController. Siga os seguintes 
passos: 

Abra o arquivo OpcoesController.xib e adicione um botão com o texto 
“Fechar” e conecte uma action chamada “close” no arquivo OpcoesController.h 
(lembre-se de usar o Assistant Editor para ver o arquivo .xibe .h lado a 
lado). Em seguida, abra o arquivo OpcoesController.m e chame o método 
dismissViewControllerAnimated:complet ion, conforme abaixo: 


- (IBAction)close: (id)sender { 
[self dismissViewControllerAnimated:YES completion:nil]; 


Rode novamente o aplicativo “clique” no botão “Fechar”, para que o controlador 
seja fechado. 


4.3 NAVEGAR POR DIFERENTES TELAS COM O UINAVIGATI- 
ONCONTROLLER 


Uma das formas de navegação mais comum em aplicativos iOS é aquela em que, feita 
uma determinada ação, uma nova tela desliza da direita para a esquerda por cima da 
anterior. Depois, através de um toque em um botão no canto superior esquerdo 
(geralmente um botão escrito “Back” ou “Voltar”), volta-se para a tela anterior. Ou 
seja, é uma navegação hierárquica. 

Este tipo de navegação chama-se “Controlador de Navegação”, ou no termo téc- 
nico, UlNavigationController. Nos exemplos iremos nos referir a este com- 
ponente pelo nome navigation controller, pois é um termo bastante conhecido em 
desenvolvimento iOS, e acostumar-se com ele facilitará a busca por informações na 
Internet, posteriormente. A figura 4.5 mostra como ele funciona. Ela deve permitir 
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que troquemos de uma tela para outra, de uma funcionalidade para outra, através de 


uma interface simples. 
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Figura 4.5: Funcionamento de um UINavigationController 


Navigation controllers são peças muito importantes em aplicações iOS, pois per- 
mitem a transição de um controller para outro sem que haja perda de estado. Em 
outras palavras, o aplicativo literalmente vai empilhando os controladores, sem tirá- 


los da memória, permitindo que a navegação reversa seja feita de maneira natural. 








GERENCIAMENTO DE MEMÓRIA DE CONTROLADORES 


Em condições normais de funcionamento, os controladores que estão 
na hierarquia de um Navigation Controller são sempre mantidos em me- 
mória. Porém, não devemos trabalhar com a premissa de que isso será 
sempre verdade, pois no caso de falta de memória, o iOS pode “descar- 
regar” alguns deles, recriando-os quando necessário. 








Para entender melhor o funcionamento do UlNavigationController, va- 


mos criar um aplicativo de um catálogo de empresas, no qual é possível adicionar 
novos registros e realizar configurações. 


Crie um novo aplicativo do tipo “Single View Application”, nos mesmos mol- 
des dos exemplos anteriores, e chame-o de “NavigationControllerDemo”. Você 


deverá ter um projeto padrão, com o AppDelegate e uma classe chamada 
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ViewCont roller. Repare que este nome, “ViewController”, que o Xcode cria junto 
com o projeto, é apenas para nossa conveniência, porém você não precisa ficar amar- 
rado a ele. 

Para começar, vamos mudar o nome da classe “ViewController” para algo se- 
manticamente melhor. Uma das maneiras de fazer isso é renomear manualmente os 
arquivos ViewController.me .h, porém isso dá muito trabalho e corremos o 
risco de esquecer alguma coisa. Uma maneira mais inteligente é utilizar a funciona- 
lidade de refatoração do Xcode, que faz para nós todo trabalho pesado. 

Abra o arquivo ViewController.me, na linha de definição da classe (onde 
tem Gimplementation ViewController) clique com o botão direito e seleci- 
one a opção Refactor -> Rename.. ., conforme a figura 4.6. 





e00 ES NavigationControllerDemo.xcodeproj — [m] ViewController.m a 
> RE | A) [ iPhone Ret... NavigationControllerDemo: Ready | Today at 6:53 PM No Issu E E [al BO E Oð 
mma A O I @ im] < |Ñ NavigationControlleDemo > Q Navigatio... > [m] ViewController.m > [E @implementation ViewController 

NavigationControllerDemo A 

rã 2 targets, iOS SDK 7.0 2 4! ViewController.m 

v [=] NavigationControllerDemo - e gn donconsronharDao 


lh) AppDelegate.h 


[m] AppDelegate.m gimport "ViewController.h" 


[E] Main.storyboard 3 Ginterface ViewController; () 

[R] ViewController.h 

5 e @end Cut 
s5 n Copy 

(E Images.xcassets 2 implementation NiewContr 


> C] Supporting Files Paste 


> C] NavigationControllerDemoTests 


> C] Frameworks 1 [super viewDidLoad] ; 
> [Products ap 44 Do any additional 3 E a aid. 


- (void)viewDidLoad 
t Find Selected Text in Workspace... 


w Issue 

Jump to Definition 
— (void)didReceiveMemoryW 
{ 








Isuper didReceivememg Structure > 
4! Dispose of any res 
( 
Gend 
Refactor > Rename... 
+00 6G Extract... 


— Open in Assistant Editor Create Superclass... 
E Ee, ec: Nisar Creata sup p 
Reveal in Symbol Navigator Move Down:.: 
Show in Finder Encapsulate... 


lue 


Speech > 


Na caixa de diálogo que abrir, informe o valor “RootController” no campo de 
texto, e deixe marcada a opção “Rename related files”, para que o Xcode renomeie 
todos os arquivos que tenham relação ao original ViewController. 

Ao clicar no botão “Preview”, o Xcode irá mostrar um resumo das operações 
que serão realizadas. Clique no botão “Save”, e caso o Xcode mostre uma mensagem 
perguntando se deve fazer backup do conteúdo, clique em “Enable”. 
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Ao término da operação, repare que tanto os arquivos em disco como 
as próprias definições da classe ViewController foram renomeadas para 


RootController. 


4.4 PREPARAR A TELA PRINCIPAL 


Agora precisamos colocar botões no RootCont roller para chamar os outros con- 
troladores, um para a fictícia tela de adicionar empresas ao catálogo, e outro para a 
— adivinhem — também fictícia tela de configurações. O objetivo principal desta 
seção é demonstrar como navegar de um lugar para o outro, e não na implementação 
real de um catálogo propriamente dito. 

Abra o arquivo Main.storyboard e coloque 2 botões, o primeiro como texto 
“Adicionar”, e o segundo com o texto “Configurações”, conforme mostra a figura 4.6. 
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Catálogo de empresas 


Adicionar 


Configurações 











Figura 4.6: Desenho da tela principal do aplicativo 
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POR QUE EDITAR O ARQUIVO MAIN.STORYBOARD? 


O motivo pelo qual, neste ponto, é necessário editar o arquivo 
Main.storyboard, se deve ao fato que ele é a forma padrão pela qual 
o Xcode cria projetos do tipo “Single View Application” (além de al- 
guns outros), sendo o ponto de partida da app. Esta é também uma 
forma da Apple estimular o uso de Storyboards em detrimento do an- 
tigo formato que se baseada apenas em arquivos “ .xib” Somado a 
isso, você deve se lembrar que todo novo projeto também inicia com 
a classe “ ViewController”, que anteriormente renomeamos para “ 
RootController”, e esta mesma classe também está configurada como 
sendo a primeira que o aplicativo deverá utilizar, quando o aplicativo for 
iniciado. 

No capítulo 5 veremos mais a fundo este assunto. 











4.5 CONECTAR AS AÇÕES DOS BOTÕES 


Da mesma forma como já fizemos diversas outras vezes durante o livro, para que 
os botões tenham utilidade é necessário conectar as ações deles ao código, utili- 
zando a já conhecida abordagem “Selecionar componente -> Arrastar com CTRL 
para o arquivo .h -> Connection do tipo Action”. Mais fácil que devorar o bolo de 
chocolate da vovó. Chame a ação do botão “Adicionar” de “abrirAdicionar” e 
para segundo botão nomeie a ação de “ abrirConfiguracoes” O seu arquivo 
RootController.h deverá ficar assim: 


# import <UIKit /UIKit.h> 
Ointerface RootController : UlViewController 
- (IBAction)abrirAdicionar: (id)sender; 


- (IBAction)abrirConfiguracoes: (id)sender; 


@end 


4.6 CRIAR A TELA DE ADICIONAR EMPRESA 


Adicione uma nova classe ( Command + N) chamada AdicionarController da 
mesma forma como criamos o RootCont roller, lembrando de selecionar a opção 
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para criar o arquivo .xib, e adicione apenas um label com o texto “Tela adicionar 
empresa” no arquivo AdicionarController.xib. Lembre-se que o objetivo é 
focar na navegação entre os controladores, e não na funcionalidade de adicionar 
empresas propriamente dita. 


4.7 NAVEGAR DE UM CONTROLADOR PARA OUTRO 


A classe UlViewController contém uma propriedade cha- 
mada navigationController que representa a instância do 
UlNavigationController utilizada pelo aplicativo, sendo que os princi- 
pais métodos são dois: 


* pushViewController:animated, para navegar para um outro controla- 


dor 





* popViewControllerAnimated, para voltar um nível na hierarquia. 


Para ir do RootController para a tela de adicionar empresa, implemente o 
método abrirAdicionar no arquivo “RootController .m” da seguinte forma 
(obs: lembre-se de importar o arquivo AdicionarController.h): 


- (IBAction)abrirAdicionar: (id)sender { 
AdicionarController *c = [[AdicionarController alloc] init]; 
[self .navigationController pushViewController:c animated:YES]; 


Rode o aplicativo ( Command+R) e interaja com o botão “Adicionar”. Acon- 
teceu alguma coisa? Muito provavelmente não, pois apesar da propriedade 
navigationController fazer parte da API da classe UlLViewController,ova- 
lor dela não é criado automaticamente pelo iOS. Portanto, é nossa responsabilidade 
disponibilizar um UlNavigationController e instruir o aplicativo a utilizá-lo. 


4.8 ASSOCIAR UM UINAVIGATIONCONTROLLER AO PRO- 
JETO 

Conceitualmente um UlNavigationController não deve ser estendido, mas 

sim ser utilizado diretamente. Imagine o navigation controller como sendo um ge- 


renciador, que recebe uma referência para o controlador inicial, e a partir dai permite 
a navegação para os outros através do método pushViewController:animated. 
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A propriedade navigationController da classe UlViewController é 
vazia em controllers que não façam parte da hierarquia de um navigation control- 
ler (o que faz bastante sentido). Porém, a partir do momento em que criamos um 
UINavigationController, o iOS atribui automaticamente um valor válido para 
a propriedade do controlador principal e de todos os outros que fizerem parte da 
navegação. Isso é bastante prático, pois não precisamos nos preocupar em manter 
uma referência global ao navigation controller e atribuí-lo manualmente aos demais. 

Para adicionar um navigation controller ao projeto, abra o arquivo 
Main.storyboard e selecione a barra preta na parte inferior, conforme 








mostra a imagem 4.7, e em seguida acesse o menu “ Editor -> Embed In 
-> Navigation Controller” O resultado ficará como o da imagem 4.8. 


CEE 


Figura 4.7: Clique na barra para selecionar o controlador 
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Catálogo de empresas 


Adicionar 


Configurações 


K<) G Root Controller 


Figura 4.8: Navigation Controller associado ao projeto 


Rode novamente o aplicativo e interaja com o botão “Adicionar”, e veja que desta 
vez a tela do AdicionarController é exibida corretamente. Uma outra coisa 
nova é que o aplicativo apresenta uma barra superior de navegação — chamada de 
“Navigation Bar” —, onde um botão com o título “Back” aparece no canto supe- 
rior esquerdo quando navegamos de um lugar para o outro. Tecnicamente funciona 
desta maneira: ao executarmos pushViewController:animated, o iOS usará o 
título do controlador anterior (representado pela propriedade title) como texto 


r 


do botão e, caso não haja nenhum título definido, o texto “Back” é utilizado. 


4.9 CRIAR OS DEMAIS CONTROLADORES 


O nosso aplicativo também precisa de uma hipotética tela de configurações — aliás, 
duas. A primeira delas contém algumas coisas gerais, como se o catálogo deve ser 
utilizado em “Modo seguro” e se os dados devem ser salvos automaticamente ou 
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não. Além disso, precisamos dos dados de acesso do usuário. Para o primeiro caso 
crie um novo controlador chamado ConfguracoesCont roller como feito ante- 
riormente, e adicione alguns componentes para parecer que ele tem utilidade, como 


exemplificado na figura 4.9. 


A 








eoo E3 NavigationControllerDemo.xcodeproj — [A ConfguracoesController.xib n 
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Figura 4.9: Exemplo da tela principal de configurações 





IMPLEMENTE O MÉTODO ABRIRCONFIGURACOES: 


Não esqueça de implementar o corpo do método 
abrirConfiguracoes: no arquivo RootController.m, seguindo 
a mesma lógica do que foi feito para o método abrirAdicionar:, 
porém desta vez instanciando o ConfiguracoesController. 











Além disso, esta tela deverá chamar uma outra tela, portanto conecte a ação do 
botão “Dados de acesso” ao método abreDadosAcesso:, conforme a listagem 


abaixo: 
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// ConfiguracoesController.h 
t import <UIKit /UIKit.h> 


Ginterface ConfiguracoesController : UlViewController 
- (IBAction)abreDadosAcesso: (id)sender; 


@end 


Para a tela de “Dados de acesso”, crie um novo controlador chamado “DadosA- 
cessoController” e adicione alguns campos, conforme a figura 4.10. Para esta tela não 
há necessidade de código adicional por enquanto. 


Dados de acesso 








Figura 4.10: Exemplo das configurações de acesso 


Agora, no arquivo ConfiguracoesController.m, implemente o corpo do 
método abreDadosAcesso: para que o DadosAcssoController seja aberto 
quando solicitado, conforme demonstrado abaixo: 
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- (IBAction)abreDadosAcesso: (id)sender { 
DadosAcessoController *c = [[DadosAcessoController alloc] init]; 
[self.navigationController pushViewController:c animated:YES]; 


Execute o aplicativo ( Command + R) e navegue entre os controladores, e veja 
como o UlNavigationController cuida da parte de transição entre eles. Neste 
ponto deverá ser possível navegar conforme demonstrado na figura 4.11. 


Carrier F 8:40 PM -= 


< Back 


Tela adicionar empresa 


Carrier F 8:40 PM — 
Catálogo de empresas 


Carrier S 8:40 PM -= 


Back 
Adicionar < 
Carrier F 8:40 PM — 


5 Back 
Configurações < Bac Login 
Modo seguro 
Senha 


Salvar automaticamente O 








Dados de acesso 


Figura 4.11: Estrutura da navegação 


4.10 ESCONDER A BARRA SUPERIOR DE NAVEGAÇÃO 


Certas vezes não há a necessidade de deixar a barra de navegação superior 
(a “Navigation Bar”) do UlNavigationController visível o tempo todo, 
caso ela não agregue funcionalidade, e o ideal seria escondê-la e mostrar so- 
mente quando necessário. Para obter este resultado basta executar o método 
setNavigationBarHidden:animated do UINavigationController, lem- 
brando que ele é representado pela propriedade navigationController. Adici- 
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one a linha de código abaixo no método viewWillAppear:animated da classe 
RootViewController,e rode novamente o aplicativo. 


// RootController.m 
- (void) viewWillAppear: (BOOL)animated { 
[self .navigationController setNavigationBarHidden:YES animated:YES]; 


Contudo, quando navegamos na hierarquia para outro controlador, a barra de 
navegação continua escondida, impossibilitando de navegarmos para o nível an- 
terior. Para solucionar este problema basta fazer o processo inverso nas classes 
ConfguracoesControllere AdicionarController, conforme demonstrado 
abaixo: 


// Nos controladores Configurações e Adicionar 
-(void) viewWillAppear: (BOOL)animated { 
[self .navigationController setNavigationBarHidden:NO animated:YES]; 


Rode novamente o aplicativo (menu Product -> Run) e veja a diferença no fun- 
cionamento. 
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Storyboards 


Historicamente, a maneira de construir aplicações iOS consistia em criar uma série 
de controladores, cada um de maneira independente do outro, e frequentemente 
com arquivos .xib para a criação do layout. Como vimos no capítulo 4, ainda 
é possível construir aplicações desta forma, porém agora existe a opção de utilizar 
storyboards no lugar de controladores independentes. 

A grande vantagem de storyboards é que eles nos permitem definir visualmente 
como as interações entre as muitas telas dos aplicativos irão ocorrer, tudo isso em um 
único arquivo, o que nos dá uma visão ampla de todas as rotas possíveis. Aplicativos 
costumam ter um único storyboard, embora tecnicamente seja possível haver mais 
deles. 

Tenha em mente que storyboards são uma maneira de criar controladores e defi- 
nir como eles interagem entre si - por exemplo, como ir de um para o outro -, porém 
nada muito além disso. Tudo o que já foi mostrado no livro, e tudo mais o que ainda 
será demonstrado, pode trabalhar em conjunto com storyboards. 
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Os TERMOS DE STORYBOARDS 


Quando falamos de storyboards em iOS, frequentemente veremos os 
seguintes abaixo. Como curiosidade, este é um termo que a Apple em- 
prestou de outras artes, como filmes e teatro. 


* Scene: termo em inglês para “Cena”, daquela mesma de teatro ou 
TV, que é cada tela em si. No livro utilizaremos o termo em inglês, 
pois é algo bem próprio de storyboards e lhe ajudará em futuras 
pesquisas sobre o assunto. Na prática Scenes e controladores (vide 
abaixo) estão diretamente ligados, não sendo possível ter um sem 
o outro. 


e View Controller: já vimos bastante sobre controladores, e eles for- 
mam uma parte fundamental de storyboards, trabalhando direta- 
mente em conjunto com scenes. Tudo o que você já aprendeu sobre 
controladores no livro se aplica no caso de storyboards. 


e Segue: éo conceito que defini a transição de uma scene para outra. 
O termo em inglês e português são iguais. 











5.1 PROJETO E CONCEITOS GERAIS 


Crie um novo projeto do tipo “Single View Application” com as configurações 
padrão, chamado “DemonstracaoStoryboards”, e em seguida abra o arquivo “ 
Main.storyboard” À imagem 5.1 mostra a estrutura inicial de uma storyboard. 
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E |[B 10: Bj[a /=/e 


Figura 5.1: A estrutura inicial de uma storyboard 


A seta indicada pelo item 1 informa que este controlador é o ponto de partida 
(controlador inicial) da storyboard, o item 2 é a Scene (que é a porção da view), 
enquanto que o item 3 é o controlador propriamente dito. Portanto, se você quiser 
definir propriedades da Scene (ou da view, utilizando um outro termo) clique em 
qualquer área da região branca, indicada pelo número 2. Por outro lado, caso queira 
definir propriedades do controlador, como título, opções de transição para outras 
Scenes, métricas de simulação de interface e afins, clique na barra preta localizada 
na parte inferior da Scene, indicada pelo número 3 na imagem - na prática, o con- 
trolador é o elemento amarelo localizado na extremidade esquerda da barra preta. 

Neste capítulo será mostrado o funcionamento de storyboards sem focar em de- 
talhes de um programa específico - mais adiante no livro construíremos um aplica- 
tivo mais completo que também fará uso mais extensivo de storyboards, ajudando 
assim a firmar os conceitos. Por enquanto, o importante é focar na maneira como ele 
funciona, o que é bastante simples. O aplicativo consiste em uma serie de telas fic- 
tícias, com alguns níveis de navegação auxiliados por um por navigation controller, 
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com os quais serão demonstrados as formas de conexão e navegação de um Segue 
para outro, como invocar manualmente um Segue, e como retornar para o início da 
app sem ter que voltar manualmente tela por tela. 

A imagem 5.2 mostra o estado da storyboard do projeto desta capítulo quando 
estiver finalizada. A tela foi diminuida de tamanho para poder caber tudo em uma 
única imagem. Note que é possível visualizar toda a estrutura de navegação do apli- 
cativo, sabendo quando é a tela inicial e os possíveis caminhos de uma tela para outra. 


[ves cotroto -seire | 


Figura 5.2: Resultado final da storyboard deste capítulo 


Ao abrir o arquivo “Main. storyboard” você encontrará uma tela como a da 
imagem 5.1, onde já há um controlador, o qual será a tela (Scene) inicial do apli- 
cativo. Insira neste controlador 3 botões, chamados “Listar compromissos”, “Inserir 
novo compromisso” e “Sobre este aplicativo”, respectivamente. A imagem 5.3 mostra 
o resultado. 
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Listar compromissos 
Inserir novo compromisso 


Sobre este aplicativo 


Figura 5.3: Tela inicial do aplicativo 


Nível de zoom e organizar controladores na storyboard 


Uma coisa ruim do editor de storyboards é que, quanto mais controladores você 
adicionar, mais difícil fica visualizá-los e organizá-los no editor, o que é ainda mais 
sofrível caso você tenha um monitor pequeno (ou, pior, apenas a tela do notebook, 
como muitas pessoas). O time da Apple ainda precisa trabalhar bastante em diversas 
questões de usabilidade. 

Utilize os controles disponíveis no canto inferior direito da tela para alterar o 
nível de zoom do editor, conforme mostra a imagem [ref-labl sbz.png]. O botão 
do meio, representado pelo símbolo de igualdade (“=”) retorna o zoom a 100%. Já 
para arrastar o controlador para outra parte da tela (como quando quiser mudá-lo 
de posição, por exemplo) clique e arraste a barra preta. 
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(E| e mia laa 





Figura 5.4: Controles de zoom 


Construir a Segue ‘Sobre’ 


Como você pode deduzir pela imagem 5.3, existem três Segues para as quais 
é possível navegar a partir da Segue inicial. Vamos começar pela “Sobre este apli- 
cativo”, Com o “ Main.storyboard” aberto, abra a Object Library ( View -> 
Utilities -> Show Object Library) e arraste para a storyboard um item do 
tipo “View Controller”, e em seguida adicione neste controlador um UILabel com 
o texto “Demonstração App 1.0”. A imagem 5.5 mostra o resultado parcial. 
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Listar compromissos 


Inserir novo compromisso 


Sobre este aplicativo Demonstração App 1.0 


LE) Ene mibia)(a =a 


Figura 5.5: Resultado parcial com a tela “Sobre 





Neste ponto temos dois controladores, porém sem qualquer ligação entre eles. 
O que precisa ser feito então é informar que, a partir do toque no botão “Sobre este 
aplicativo”, o controlador “Sobre” seja adicionado. Anteriormente a storyboards este 
processo era feito manualmente, através da criação de uma action para o botão, e 
a manual instanciação do controlador. Já com storyboards a história fica bem mais 
fácil, podendo ser feito tudo visualmente pelo editor, sem qualquer necessidade de 
código. 

Clique no botão “Sobre este aplicativo”, segure CTRL e clique e arraste em direção 
ao controlador “Sobre”, de tal forma que sua área fique azulada, e então solte o clique. 
Isso fará com que uma conexão - ou melhor, a Segue - seja feita do botão para este 
controlador, conforme mostra a imagem 5.6. Na tela popup que aparecer, selecione 
o item “Push”. 
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Figura 5.6: Criar Segue do botão para o controlador 


Rode o aplicativo e clique no botão. O que aconteceu? Provavelmente o seguinte 


erro: 


Terminating app due to uncaught exception 'NSGenericException', reason: 
'Push segues can only be used when the source controller is managed by 
an instance of UlNavigationController.' 


Esta mensagem de erro está dizendo que eventos Segue do tipo “Push”, que foi 
o que selecionamos no popup na hora de fazer a conexão, precisam que exista um 
UlNavigationController associado, caso contrário não é possível navegar en- 
tre as Scenes. Para resolver isso é bem simples: selecione o controlador que tem os 





botões, já que ele é a primeira tela do aplicativo, e então vá ao menu “Editor -> 
Embed In -> Navigation Controller” que o Xcode irá adicionar e configu- 





rar ele para nós. O resultado deverá ficar como o da imagem 5.7 
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Listar compromissos 


Inserir novo compromisso 


Sobre este aplicativo 





Navigation Controller View Controller View Controller 


Figura 5.7: Storyboard após a adição do navigation controller 


Como pode ver, o primeiro controlador da storyboard (representado pela seta 
mais a esquerda) passou a ser o navigation controller, que na prática é um controla- 
dor especial que gerencia a navegação entre outros controladores. Se você selecioná- 
lo (lembre-se que para selecionar o controlador é necessário clicar na barra preta) 
e abrir o Attributes Inspector (“ View -> Utilities -> Show Attributes 
Inspector”) verá que ele está marcado como sendo a Scene inicial, conforme mos- 


tra a imagem 5.8. 
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Navigation Controller 


Bar Visibility A Shows Navigation Bar 
"| Shows Toolbar 


| View Controller 


| Initial Scene TA Is Initial View Controller 


Layout | | Adjust Scroll View Insets 
Hide Bottom Bar on Push 
CA Resize View From NIB 
Use Full Screen (Deprecated) 
Extend Edges TA Under Top Bars 


Figura 5.8: Navigation controller definido como sendo o primeiro 


Rode o aplicativo novamente e clique no botão, e veja que agora ele funciona 
corretamente. 


Ver a conexão e tipo de transição 


Se você clicar na seta entre dois controladores, poderá visualizar o botão com o 
qual a ação está associada, conforme mostra a imagem 5.9, onde o botão é identifi- 
cado com uma seleção azul. De quebra, no Attributes Inspector é possível modificar 
o tipo de transição, que no nosso caso foi definida como “Push”. 
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Storyboard Segue 


(mo) Identifier 
Listar compromissos 
Inserir novo compromisso 
Sobre este aplicativo ha Demon 





Figura 5.9: Verificar com qual botão a transição da Segue está associado 


Título dos controladores 


Como agora temos um navigation controller, ele por padrão adiciona uma barra 
superior nos controladores, onde é possível definir um título para a tela. Além disso, 
no canto superior esquerdo ele também coloca automaticamente um botão para vol- 
tar para a tela anterior, como você já deve ter notado. Seguindo a imagem 5.10, dê um 
duplo clique na região de título indicado pela seta, e escreva um texto curto e claro 
para identificar o controlador em questão - por exemplo, “Início” e “Sobre”. Veja 
ainda que, na seção “Navigation Item” do Attributes Insepector, existem três campos 
de texto, sendo que os mais interessantes são “Title”, para o texto que irá aparecer na 
barra (é o mesmo texto definid pelo duplo clique) e “Back Button”, que é o texto que 
irá ser utilizado no botão para retornar a tela anterior - caso nenhum valor seja infor- 
mado, o navigation controller irá automaticamente utilizar o título da tela anterior. 
Obs: o texto do botão “Back Button” deve ser definido no controlador “anterior”, ou 
seja, aquele para qual a navegação irá retornar. Faça alguns testes para se acostumar 
com o funcionamento. 
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Back Button 





Listar compromissos 
Clique 


Inserir novo compromisso 


Figura 5.10: Propriedades de navegação 


5.2 ADICIONAR OS DEMAIS CONTROLADORES 


Agora que sabemos o funcionamento de storyboards, vamos adicionar os demais 
controladores. O processo é igual para todos, mudando apenas o título de cada con- 
trolador. Faça assim: 


1) Adicione na storyboard um componente do tipo “ View Controller” 
localizado na Object Library ( View -> Utilities -> Show Object 
Library) 


2) Crie a Segue do botão “Listar Compromissos” para este novo controlador (clique 
no botão e depois CTRL + clique e arraste), escolhendo “Push” como 
ação. Obs: isso não pode ser feito se o zoom estiver habilitado, o Xcode não 
permite 


3) Coloque um título na barra superior deste controlador (por exemplo, “Listar”) 


4) Repita os passos 1 a 3 para a tela “Inserir novo compromisso”, com o título “Inserir” 


Neste momento o seu resultado deverá estar como o da imagem 5.11. Rode o 
aplicativo e navegue para certificar-se que tudo funciona. 
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Figura 5.11: Propriedades de navegação 


A tela de Listar e seus controladores, via código 


A tela “Listar” permite duas ações adicionais: editar e ver os detalhes de um de- 
terminado registro. Abra o controlador com o título “Listar” e adicione dois novos 
botões, um com o texto “Editar” e outro com o texto “Ver Detalhes”, porém desta 
vez não crie as Segues ainda, pois iremos fazer de uma maneira alternativa, via có- 
digo. Aprender a fazer via código é útil quando for necessário navegar para outra 
Segue de uma maneira não tradicional, como a interação com a célula de uma Table 


View, ou um botão com ações condicionais (como um botão “Login” que depois vira 
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“Logout”). 

Existem duas coisas que precisam ser feitas: a primeira é que a Segue deve ser 
criada sem estar associada com um botão específico, mas sim “de controlador para 
controlador”. Isso é feito criando a Segue através do item “View Controller” na 


barra presta, utilizando a mesma técnica de “ CTRL+clique e arraste” con- 
forme mostra a imagem 5.12. 







Editar 


Ver Detalhes 





View Controller 





e) 


(E][E itaim )(a 





Figura 5.12: Criando a Segue sem associar ela a um botão 


Repita o processo mais uma vez, agora para o outro controlador (lembre-se: um 
para editar, e outro para ver detalhes). O resultado desta parte deverá estar como a 
imagem 5.13. 
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Ver Detalhes 


View Controller - Editar 


View Controller - Listar 


View Controller - Detalhes 


Figura 5.13: Segues criadas da tela de Listar para Editar e Detalhes, sem associação 
com algum botão 
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Para que seja possível navegar entre Segues via código é necessário adicionar 
identificadores únicos a elas. Para isso, clique na seta que une as Segues e preen- 
cha o campo “Identifier” no Attributes Inspector, conforme mostra a imagem 5.14. 
Lembre-se de utilizar nomes únicos para cada segue. Como sugestão, utilize uma 
combinação do nome da Segue de origem e de destino. No caso deste exemplo, “Lis- 
tar -> Editar” deve ser chamada de “ listarParaEditarSegue” e “Listar -> De- 





talhes” de“ listarParaDetalhesSegue” 


Storyboard Segue 


Ester Identifier | listarParaEditar 


Style | Push 


Ustar 





View Controller - Editar 


Figura 5.14: Adicionar identificar a uma Segue 


Até agora todo o trabalho que realizamos foi unicamente na storyboard, sem 
precisar criar uma única classe ou linha de código. Contudo, sabemos que na vida 
real as regras de negócio são escritas em Objective-C, e para isso é necessário ter 
uma classe customizada associada ao controller, como já vimos diversas vezes no 
livro. Como agora queremos ir da Segue “Listar” para outras duas, vamos criar uma 
classe especial para ela. 





VáaomenuíFile -> New -> File.. .”, selecione “Objective-C Class” e cli- 
que em “Next”. No campo “Class” insira o valor “ListarViewController”, e no campo 
“Subclass of” certifique-se que a opção “UIViewController” esteja seleciona, pois 
queremos criar um controlador customizado. As opções “Targeted for iPad” e “With 
XIB for User Interface” devem estar desmarcadas. 

Agora volte ao storyboard, selecione a Segue “Listar”, abra o “Identity Inspector” 
(C view -> Utilities -> Show Identity Inspector”) e na seção “Cus- 


88 


Casa do Código Capítulo 5. Storyboards 





tom Class” insira o valor “ ListarViewCont roller”, conforme mostra a imagem 


5.15. 


E view Controller - Listar Scene » Ó Listar View Controller - Listar E] E VS o 


Custom Class 


Class | ListarViewController Q|r 
Identity 
Storyboard ID 


Restoration ID 
Use Storyboard ID 


User Defined Runtime Attributes 
Key Path Type Value 





Figura 5.15: Identificador da Segue 


Tendo feito isso, abra o Assistant Editor (“ CTRL+ENTER”) e crie as acti- 











c 


ons para os dois botões. Como sugestão, para o de Editar chame a action de * 
abrirEditarScene” e“ abrirDetalhesScene” para o de Detalhes. O arquivo 





ListarViewController.h deverá estar como o código abaixo: 


t import <UIKit /UIKit.h> 
Ointerface ListarViewController : UlViewController 


- (IBAction)abrirEditarScene: (id)sender; 
- (IBAction)abrirDetalhesScene: (id)sender; 


@end 


Todo controlador já contêm um método chamado 
performSegueWithIdentifier, que serve para navegar dele para ou- 
tra Segue utilizando o identificador definido anteriormente. O arquivo 
ListarViewController.m deve conter a implementação dos métodos “abrir” 


conforme abaixo: 


- (IBAction)abrirEditarScene: (id)sender { 
[self performSegueWithIdentifier:0"listarParaEditarSegue" 
sender: sender] ; 


- (IBAction)abrirDetalhesScene: (id)sender { 
[self performSegueWithIdentifier:0"listarParaDetalhesSegue" 
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sender: sender] ; 


Rode o aplicativo e interaja com os botões para ver o resultado. 


5.3 NAVEGAR DE VOLTA DIRETAMENTE PARA A SEGUE INI- 
CIAL 


Uma das coisas atreladas ao uso de Navigation Controllers é que, a medida em que 
navegamos de um controlador para outro, eles vão sendo colocados em uma pilha, 
um em cima do outro, e para voltar para as telas anterior é preciso ir clicando no 
botão “Voltar” (aquele do canto superior esquerdo). Só que quando queremos voltar 
para algum mais distante, é necessário fazer isso várias vezes. 

Com storyboards existe uma maneira de tornar este processo um pouco mais 
fácil, através do uso da ação de “Saída”, do termo em inglês “Exit”. Na verdade, o 
termo utilizado pela documentação é “Unwind Segue”, porém no Xcode a palavra 
“Exit” é utilizado, para nos confundir um pouco! 

Funciona assim, em dois passos: adicionamos um método com qualquer nome 
na Segue para onde deseja-se retornar (por exemplo, “ resetarNavegacao”) e que 
receba um argumento do tipo UlStoryboardSegue, e ai na Segue de origem, que 
irá disparar a ação, fazemos um link entre o botão e a ação de Unwind, ou Exit. 

Para demonstrar, vamos definir que queremos voltar da Segue “Detalhes” 
( Inicio -> Listar -> Detalhes) para o início da app. Para isso, adi- 
cione uma nova classe chamada “é InicioViewController” que herde de 
UlViewController como feito anteriormente (não esqueça de informar o nome 
dela no campo “Custom Class” do Identity Inspector na Storyboard). Ai abra o ar- 
quivo “ InicioViewController.m” e adicione o seguinte código: 


- (IBAction)resetarNavegacao: (UIStoryboardSegue *) segue { 
// Nao precisa de código 


Veja que o corpo do método é vazio mesmo, embora você possa colocar algum 
código caso queira - porém isso não é obrigatório. 

Para o segundo passo, vá até a Segue “Editar” na Storyboard (não é necessá- 
rio criar uma classe customizada) e adicione um botão com o texto “Voltar para o 
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início”. Em seguida, selecione o botão, segure CTRL e clique + arraste para o bo- 


tão verde, conforme mostra a imagem 5.16. No popup que abrir, selecione o item “ 


resetarNavegacao” 


Editar 
o o o 
tVoltar para o ițicio 
) o o o 











Figura 5.16: Associar a ação Unwind a um botão 


Rode o aplicativo e veja o resultado. 


c 
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Informar se a Segue pode aceitar a ação de Unwind 


Existe um método de implementação opcional que serve para indicar se aquele 
controlador pode ou deve aceitar a ação de Unwind, com base em condicionais cri- 
adas pelo desenvolvedor, como local (Segue) de origem e de destino. Caso este mé- 


(a 


todo retorne “ YES”. Um outro caso que ele pode ser necessário é quando a ação 





de Unwind passa por diversas Segues intermediárias e o retorno acaba parando “no 
meio do caminho” mesmo quando não deveria. Nestes casos, portando, implemente 
o método e retorne “ NO”. Veja o código abaixo: 


- (BOOL) canPerformUnwindSegueAction: (SEL)action 
fromViewController: (UlViewController *)fromViewController 
withSender: (id)sender 1 


return YES; 


c 


Retornar “ YES” indica que o controlador pode manipular a ação de Unwind, 





onde neste caso deverá ter também implementado o método indicado no popup do 
botão verde, como feito anteriormente. Já “ NO” faz a ação passar direto. 


5.4 PASSAR DADOS DE UMA SEGUE PARA OUTRA 


Um detalhe fandamental com o uso de storyboards é que os controladores são cria- 
dos automaticamente, portanto não temos como passar objetos e outras referências 
pelo construtor, como geralmente é feito da forma manual. A abordagem consiste, 
portanto, em sobrescrever um método especial existente em UIViewController 


chamado “ prepareForSegue”, o qual é executado momentos antes da transição 





para a próxima Segue. 

Este método passa como argumento informações sobre a Segue que está para ser 
executada, incluindo seu identificador e a referência para o controlador. Com isso, 
objetos podem ser atribuídos através de propriedades. Para demonstrar o conceito 
é necessário mexer em dois controladores - o de origem e o de destino. No caso, a 
intenção é passar dados para o controlador “Detalhes” (que ainda não foi criado), 
vindo do “Listar” (o qual já criamos). 

Primeiro crie um novo controlador chamado “ DetalhesViewCont roller” e 
associe-o à tela de detalhes através do campo “Custom Class” no Identity Inspector. 
Além disso, adicione também um VUILabel, fazendo a devida ligação com o ar- 
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quivo “ DetalhesViewController.h” através da técnica de “CTRL + clique 
e arraste” À imagem 5.17 serve de referência. 


alhes View Controller - Detalhes Scene @ Detalhes View Controller - Detalhes D E VS o 
Custom Class 


Class | DetalhesViewController O v 






Detalhes Identity 


_] Use Storyboard ID 


User Defined Runtime Attributes 
| Key Path Type Value 


+ — 
| Document 
Label | Xcode Specific Labe 


XX umas 





Figura 5.17: Segue de Detalhes com a classe definida 


Aproveitando que estamos mexendo no controlador de Detalhes, adicione uma 
propriedade chamada “ descricaoDetalhes” que será aquela preenchida antes 
de navegar para a Segue, através da tela de listagem. O código deverá ficar assim: 


Ointerface DetalhesViewController : UlViewController 


Oproperty (weak, nonatomic) IBQutlet UlLabel *infoLabel; 
Oproperty (nonatomic, retain) NSString *descricaoDetalhes; 


@end 


Feito isso, o próximo passo é interceptar o evento de navegação para a Segue, e 
definir um valor para a propriedade “ descricaoDetalhes". Abra a classe 
"ListarViewController.m 


// Obs: não esqueça de importar o arquivo "hhADetalhesViewController.hyh" 
- (void) prepareForSegue: (UIStoryboardSegue *)segue sender: (id)sender 1 
if ([segue.identifier isEqualToString:0"listarParaDetalhesSegue"]) 1 
DetalhesViewController *dc = segue.destinationViewController; 
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dc.descricaoDetalhes = 0"Conteúdo vindo da tela de listagem"; 


O código não tem maiores mistérios: primeiro verifica-se se a Segue que irá 
ser exibida é a que queremos manipular, através do identificador definido anterior- 
mente, e em seguida simplesmente pegamos a referência ao controlador para definir 
algum valor a propriedade “ descricaoDetalhes”. Esse padrão pode - aliás, deve 
- ser repetido sempre que você quiser passar dados de uma Segue para outra. 

Rode o programa e veja o resultado. Apareceu na tela o texto que foi defi- 
nido? Provavelmente não, pois esquecemos de um detalhe: configurar o texto da 
UlLabel. Abra o arquivo “ DetalhesViewController.m” e implemente o mé- 


todo “ viewDidLoad” conforme abaixo: 


- (void)viewDidLoad 
{ 
[super viewDidLoad] ; 
_infoLabel.text = _descricaoDetalhes; 


Simples, não?! Agora você já sabe tudo o que é necessário para trabalhar com 
storyboards. 
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Realizando operações com a 
Internet 


Agora você já conhece todo o essencial da API do iOS. Além disso, sempre preci- 
samos utilizar diversas bibliotecas extras, sejam elas da própria API fornecida pela 
Apple ou através de bibliotecas open source que realizam as mais diferentes tarefas. 

Vamos aprender a usar uma biblioteca externa com uma situação bem comum: 
baixar arquivos pela rede para poder utilizá-los, sejam figuras, arquivos de configu- 
ração ou dados. 

O código-fonte deste capítulo está disponível na pasta “VisualizadorImagens” 
e “ExemploDownload” (lembrando que o endereço do site com os códigos está na 
introdução do livro). 


6.1. Conheça a biblioteca AFNetworking Casa do Código 





6.1 CONHEÇA A BIBLIOTECA AFNETWORKING 


Realizar operações de rede, como download ou upload de arquivos, além de intera- 
gir com APIs de serviços como Twitter e Facebook, são operações bastante comuns 
em aplicativos iOS. Com o amadurecimento da plataforma, diversas bibliotecas que 
antes existiam apenas para Mac OS foram portadas para iOS, tornando o acesso à 
documentação, exemplos e solução de problemas algo muito mais fácil de conseguir 
atualmente. 

A biblioteca AFNetworking, que abordaremos neste capítulo, é uma das que 
mais se destacam na comunidade de desenvolvedores devido à sua API moderna 
e ativa comunidade. AFNetworking funciona tanto em iOS quanto em Mac OS 
X. Ela é feita sob a fundação de networking do próprio sistema operacional, ti- 
rando proveito do que há de melhor para trabalhar com comunicação de rede, 
tendo por padrão inclusive classes para lidar com conteúdo XML e JSON (além 
das operações normais), o que é de grande utilidade. A página oficial do projeto 
é https://github.com/ A FNetworking/AFNetworking, e no livro utilizamos a versão 
2.0. 

O primeiro exemplo consiste em fazer o download de um arquivo para uma pasta 
dentro do nosso aplicativo, mostrando ao usuário uma barra de progresso à medida 
que o download é realizado. 

Crie um novo projeto no Xcode do tipo Single View Application chamado “Exem- 
ploDownload”. 

Em seguida, baixe o projeto disponível no endereço https://github.com/ 
AFNetworking/AFNetworking/zipball/master e descompacte-o em qualquer diretó- 
rio. Neste pacote, copie a pasta “AFNetworking” para o diretório do projeto “Exem- 
ploDownload” onde se encontram as outras classes do projeto (AppDelegate, View- 
Controller e outras). 


Tendo feito isso, precisamos adicionar as classes do AFNetworking no nosso 





projeto. Para tanto, selecione o menu File -> Add Files to "Exemplo 
Download" e selecione o diretório do AFNetworking que você copiou no passo an- 
terior (selecione o diretório mesmo, não os arquivos dentro dele). O resultado no 
Xcode deverá ficar como o da figura 6.1. 
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a ExemploDownload 
2 targets, IOS SDK 7.0 


w [ JAFNetworking 
AFHTTPRequestOperation.h 
AFHTTPRequestOperation.m 
AFHTTPReque...tionManager.h 
AFHTTPReque...tionManager.m 
AFHTTPSessionManager.h 
AFHTTPSessionManager.m 
AFNetworking.h 
AFNetworkRea...ilityManager.h 
AFNetworkRea.. .lityManager.m 
AFSecurityPolicy.h 
AFSecurityPolicy.m 
AFURLConnectionOperation.h 
AFURLConnectionOperation.m 
AFURLRequestSerialization.h 
AFURLRequestSerialization.m 
AFURLResponseSerialization.h 
AFURLResponseSerialization.m 
AFURLSessionManager.h 
AFURLSessionManager.m 
emploDownload 
AppDelegate.h 
AppDelegate.m 
Main.storyboard 
[R] ViewController.h 
[m| ViewController.m 
Images.xcassets 

> [|] Supporting Files 
> | | ExemploDownloadTests 
> [ ] Frameworks 
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Figura 6.1: Estrutura do projeto após importar o AFNetworking 


Compile o projeto ( COMMAND+B), e se correu tudo sem problemas, você deverá 
ter um resultado como o da figura 6.2. 


ExemploDownload.xcodeproj 
| Build ExemploDownload: Succeeded | Today at 9:22 PM 





6.2 CRIANDO A INTERFACE DE DOWNLOAD 


O objetivo deste aplicativo é solicitar ao usuário o endereço de um arquivo a ser bai- 
xado, e mostrar o progresso a medida em que o download ocorre. Não faz diferença 
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se for um arquivo ZIP, Imagem ou qualquer outro formato, o ideal é apenas que seja 
grande o suficiente para ver a barra de progresso em funcionamento (ex: 3 MB para 
uma conexão lenta, 30 MB para conexões um pouco mais rápidas). Ao término do 
download será mostrado um alerta com o tamanho total do arquivo baixado. 


Abra o arquivo Main.storyboard e adicione os seguintes componentes: 


1) Label, com o texto “URL do arquivo” 

2) Text Field, onde será informado o arquivo a baixar 

3) Um Button com o texto “Download” 

4) Um componente “Progress View”, que será a nossa barra de progresso 


5) Um componente “Activity Indicator View”, que é aquela “rodinha” que fica gi- 
rando enquanto alguma ação está acontecendo 


A figura 6.2 mostra como deverá ficar a interface. 
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URL do arquivo 


Download 





Figura 6.2: Resultado da construção da interface do aplicativo 


6.3 CONECTANDO OS COMPONENTES COM O CÓDIGO 


Agora que temos a UI (“User Interface”, ou interface com o usuário) criada, precisa- 
mos conectar os componentes ao código, a fim de podermos manipulá-los. Lembre- 
se que o arquivo .storyboard contém apenas a representação visual dos elementos 
de uma determinada tela, e a conexão com o código-fonte deve ser feita manual- 
mente. Existem duas formas distintas de fazer isso: 


1) Usando o “mini-wizard” do Xcode, que faz todo o trabalho pesado (já utilizada 
em capítulos anteriores) 


2) Da forma tradicional (como era até o Xcode 3) 
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Dependendo do tamanho do seu monitor, a quantidade de painéis abertos no 
Xcode pode tornar a tela bastante “poluída”, portanto pessoalmente costumo fazer o 
seguinte: 


e Abra Assitant Editor (View -> Assistant Editor -> Show Assistant Editor) 
* Feche o painel Navigator (View -> Navigators -> Hide Navigator) 


e Abra o painel Utilities (View -> Utilities -> Show Utilities) 


Lembrando que esta é apenas uma configuração sugerida, porém você deve tra- 
balhar da maneira que achar mais produtivo e confortável. Contudo, para as expli- 
cações abaixo assume-se que a configuração de telas sugerida é a que estará sendo 
utilizada. 

A primeira maneira já vimos como fazer nos capítulos anteriores, que é aquela 
onde seguramos CTRL e arrastamos uma linha do componente até o arquivo .h. A 
segunda maneira consiste em primeiro declarar manualmente o código relevante no 
arquivo .h, para em seguida realizar as conexões. 

Com os arquivos Main.storyboarde ViewController.h abertos lado a 
lado (veja a imagem 6.3), comece editando o arquivo ViewCont roller .h para que 
fique conforme a listagem abaixo: 


Ginterface ViewController : UlViewController 

OGproperty (nonatomic, weak) IBQutlet UlTextField *downloadField; 
- (IBAction)startDownload: (id)sender; 

Gend 


Na linha 2 declaramos o campo de texto que será usado para informar a URL 
do arquivo a baixar, e na linha 5 é declarada a assinatura do método para iniciar o 
download em si. 
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m| <a > B ExemploDownload E. B M. [5 Main.storyboard (Base) No Selection m | <4 > | E Aut. [h) ViewController.h > No Selection | 4 2 >| BB 
1 #import <UIKit/UIKİt.h> 
@interface ViewController : ewController 
CL) gend 
URL do arquivo 
Download 
LB) B | S mia Bjja =a 











Figura 6.3: Main.storyboard e ViewController.h lado a lado 


Agora faça os seguintes passos: 


* Selecione o text field no arquivo Main.storyboard 


e Abra o painel Connections, através do menu View -> Utilities -> 
Show Connections Inspector 


* No painel Connections, clique e arraste a bolinha “New Referencing Outlet” 
para cima da declaração do UT TextField no arquivo .h 


Veja a figura 6.4 para referência. 
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[3 ExemploDownload.xcodeproj — [E Main.storyboard A 


nploDownload: Succeeded | Today at 9:40 PM à E] E] al DO =] mi| 








iim | < > | [E] Automatic > [h] ViewController.h > No Selection 4<2:> 00 neeger eoo 
#import <UIKit/UIKit.h> Touch Drag Enter 








ollos 


- Touch Drag Inside 
TextField *downloadEiald. eds 


Touch Drag Outside 
Touch Up Inside 


Touch Drag Exit 1 
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toggleBoldface: O 

toggleltalics: O 

toggleUnderline: O 
DOE 


Activity Indicator View - Provides 
= feedback on the progress of a task or 
d) process of unknown duration. 


Figura 6.4: Passos para conectar o Outlet ao text field 


Dessa forma, conectamos a propriedade downloadField que foi declarada no 
arquivo .h com o componente visual, permitindo manipulá-lo da maneira que for 
necessária. Caso contrário, o text field seria apenas um artefato puramente visual, 
sem qualquer utilidade. 

O próximo passo é conectar a ação do botão que realiza o download. Os proce- 
dimentos são muito parecidos com o de conectar o text field, com a diferença que 
usaremos a IBAction. Os passos são: 


e Selecione o botão no arquivo Main.storyboard 


* No painel Connections aparecerá um grupo chamado “Send Events” com uma 
série de eventos possíveis que este botão pode receber. O que nos interessa é 
o Touch Up Inside, que é o responsável por lidar com um toque (ou “clique”, se 
fosse um aplicativo web ou desktop). Arraste o conector do Touch Up Inside 
para cima da declaração da IBAction criada anteriormente. Se você fizer certo, 
irá aparecer um box dizendo “Connect Action” 


Veja a figura 6.5 para referência. 
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Figura 6.5: Conectando a ação do botão de download 


Repita o mesmo procedimento para os componentes restantes: a 
barra de progresso ( UlProgressView) e o indicador de atividade ( 
UlActivityIndicatorView). Para a primeira, utilize o nome progressBar, e€ 
para o segundo, loading. 


Após tudo isso, o código do arquivo ViewController.h deverá estar como o 
exemplo abaixo: 


QGinterface ViewController : UlViewController 

Oproperty (nonatomic, weak) IBQutlet UlTextField *downloadField; 
Oproperty (nonatomic, weak) IBQutlet UlProgressView *progressBar; 
Oproperty (nonatomic, weak) IBQutlet UlActivityIndicatorView *loading; 
- (IBAction)startDownload: (id)sender; 

@end 





Volte para o “Standard editor” ( View -> Standard Editor -> 
Show Standard Editor) e abra o arquivo ViewController.m (COM- 
MANDA+SHIET+O) para implementar o corpo do método do botão de download. 
Isso é necessário porque criamos a conexão dele manualmente anteriormente. Veja 
no arquivo .m que o método - (IBAction) startDownload: (id) sender não 


existe no arquivo. Em qualquer lugar, implemente-o desta maneira: 
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- (IBAction)startDownload: (id)sender { 


6.4 REALIZAR A OPERAÇÃO DE DOWNLOAD 


A implementação completa do método startDownload: é mostrada abaixo, e é 


um pouco mais longa do que os outros códigos que vimos até agora. Contudo, apesar 


do tamanho, são poucos os pontos que merecem uma explicação mais detalhada. 


ı -(IBAction)startDownload: (id)sender { 


2 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 
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NSURL *url = [NSURL URLhWithString: downloadField.text]; 
NSURLRequest *request = [NSURLRequest requesthithURL:url]; 
NSString *saveFilename = 
[self downloadSavePathFor:url.lastPathComponent] ; 


NSLog(0"Salvando o arquivo em %0", saveFilename); 


AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] 
initWithRequest:request] ; 


operation.outputStream = [NSOutputStream 
outputStreamToFileAtPath:saveFilename append:NO]; 


[operation setCompletionBlockWithSuccess: 
“(AFHTTPRequestOperation *op, NSHTTPURLResponse *response) { 
[ loading stopAnimating]; 
-loading.hidden = YES; 
[self showMessage:0"Download finalizado com sucesso"]; 
} 
failure:^(AFHTTPRequestOperation *op, NSError *error) { 
[self showMessage: 
[NSString stringWithFormat:@"Erro no download: %0", 
[error localizedDescription]]]; 


]; 


[operation setDownloadProgressBlock: 
^ (NSUInteger read, long long totalRead, 
long long totalExpected) { 
_progressBar .progress = (float)totalRead / (float)totalExpected; 
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H; 


-progressBar.hidden = NO; 
-progressBar .progress = 0; 
-loading.hidden = NO; 

[ loading startAnimating]; 


[operation start]; 


Muitas requisições com o AFNetworking, sejam para enviar ou receber dados, 
utilizam um NSURLRequest para fazer as operações. Esse código é construído nas 
linhas 2 e 3, enquanto que na linha 9 iniciamos o objeto que irá lidar com as requi- 
sições em si, através da classe AFHTTPRequestOperation. O objeto NSURLRequest 
encapsula tudo a respeito de uma requisição HTTP, incluindo a URL, os métodos 
(GET, POST, PUT, DELETE), os headers e corpo da requisição. 

O código que se inicia na linha 15, setCompletionBlockWithSuccess:, 
utiliza um recurso avançado de Objective-C chamado blocks, que — falando de uma 
maneira bem geral — são objetos que contêm um comportamento específico, que 
será executado em um determinado momento. Blocks são tratados em detalhes no 
capítulo sobre Objective-C. O código completo do método inicia na linha 15, com 
a operação que deverá ser executada no caso de sucesso da operação, e termina na 
linha 26. A linha 21 contêm a declaração do block de código que será executado 
no caso da requisição falhar por algum motivo. A assinatura completa do método 
é setCompletionBlockWithSuccess: failure:. No caso da operação com- 
pletar com sucesso, paramos o indicador de atividade e o escondemos, conforme as 
linhas 17 e 18. 

Nalinha 28 definimos a operação que será executada (que também utiliza blocks) 
toda vez que recebermos dados do servidor — no caso, pedaços do arquivo que ire- 
mos baixar. Na linha 30 atualizamos a barra de progresso com a porcentagem até o 
momento, lembrando que os valores da UlProgressBar vão de o até 1 (ou seja, 
73% é representado como 0.73). 

Os códigos definidos em blocos são sempre executados em um outro momento, 
ao contrário de métodos “normais”. Eles são os chamados callback methods. O AF- 
Networking trabalha automaticamente em background, o que evita que a UI fique 
“congelada”, o que faria o usuário pensar que o aplicativo travou. 


O código do método downloadSavePathFor: está implementado abaixo: 
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- (NSString *) downloadSavePathFor: (NSString *) filename ( 
NSArray *paths = 
NSSearchPathForDirectoriesInDomains (NSDocumentDirectory, 
NSUserDomainMask, YES); 
NSString *documentsPath = [paths objectAtIndex:0]; 
return [documentsPath stringByAppendingPathComponent :filename] ; 


Na linha 1 e 2 pegamos a referência para o caminho do diretório Documents do 
aplicativo, e na linha 3 concatenamos com o nome do arquivo que será feito o down- 
load. Note que é um código relativamente complicado para uma tarefa tão simples; 
como você necessitará do caminho para o diretório Documents diversas vezes em seu 
aplicativo caso queira salvar arquivos, é uma boa prática implementá-lo em algum 
lugar que possa ser reaproveitado. 

Por sua vez, o código do método showMessage: não tem nenhum mistério, 


como visto a seguir: 


- (void) showMessage: (NSString *) message { 
UlAlertView *alert = [[[UIAlertView alloc] initWithTitle:O"Aviso" 
message :message 
delegate:nil 
cancelButtonTitle:0"0K" 
otherButtonTitles:nil] autorelease]; 


[alert show]; 


6.5 TRABALHANDO COM JSON E IMAGENS REMOTAS 


Além da classe de uso geral AFHTTPRequestOperation, o AFNetworking vem 
com algumas outras classes bastante práticas para lidar com JSON, XML e carrega- 
mento assíncrono de imagens — esta última se destaca por ser uma grande mão na 
roda, pois nos livra de ter que programar muita coisa caso fossemos ter que fazer o 


processo manualmente. 
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JSON 


JSON é um formato simples para transferir dados. É um subconjunto 
da notação de objeto de JavaScript, mas seu uso não requer JavaScript ex- 
clusivamente. É uma alternativa ao XML e também possibilita organizar 
os dados de forma hierárquica, conforme exemplificado abaixo: 


// Exemplo de JSON, retirado da API do site 500px.com 
{ 

id: 54007966, 

name: "winner and loser", 

times_viewed: 2548, 

rating: 74.8, 

votes_count: 985, 

image url: "http://..... "i 

images: [ 











O próximo exemplo mesclará o uso de JSON com carregamento remoto e assín- 


crono de imagens, para criar um visualizador de imagens da comunidade fotográfica 
500px (http://500px.com) . Ao iniciar, o aplicativo buscará no 500px a relação das 
últimas imagens enviadas pelos usuários, processar o resultado e mostrar as imagens 
em componente de scroll à medida que o usuário vai interagindo com o aplicativo. O 
código-fonte completo deste exemplo está localizado na pasta VisualizadorImagens, 
e na figura 6.6 você vê uma prévia do aplicativo final rodando. 


107 


6.5. Trabalhando com JSON e imagens remotas Casa do Código 





iOS Simulator - iPhone Retina (3.5-inch) / iOS 7.0.3 (118508) 





Figura 6.6: App mostrando imagens públicas do 5oopx.com 


Comece criando um novo aplicativo do tipo “Single View Application”, com as 
mesmas configurações utilizadas no exemplo anterior e chame-o de “VisualizadorI- 
magens”. Depois de criar o projeto, não esqueça de incluir o pacote do AFNetwor- 
king, copiando o diretório como na app anterior. 

A interface do aplicativo é bastante simples, consistindo apenas de um compo- 
nente UIScrollView. Abra o arquivo Main.storyboard e mude a cor de fundo 
a view para um tom escuro, como RGB 40, 40, 40. Para isso, abra o Attributes Ins- 
pector (View -> Utilities -> Show Attributes Inspector) clique no 
componente “Background”, que abrirá a mini janela “Colors” (obs: caso não apareça 
nada para você, clique na área branca da tela do aplicativo que aparece no storybo- 
ard). Nela, selecione a opção “Color Sliders” (segundo da esquerda para a direita) e 
depois “RGB Sliders”, no combo logo abaixo da lupa. Insira os valores e feche a janela 
Colors. Veja a figura 6.7 para referência. 
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Figura 6.7: Mudando a cor de fundo do componente 


Em seguida, adicione o componente “Scroll View”, disponível na Object Library 


(View -> Utilities -> Show Object Library), arrastando-o para que fi- 


que centralizado e ocupe todo o espaço disponível (O Xcode já deverá deixar o com- 


ponente automaticamente do tamanho da tela, cabendo a você apenas centralizar). 


Por último, precisamos conectar o Outlet do scroll com o código do controller, e tam- 


bém definir o mesmo controller como classe responsável para tratar dos eventos que 


o componente irá gerar. Em outras palavras, vamos tornar a classe ViewController 


como sendo o delegate do Scroll View. 





DELEGATES 





Delegate é um padrão de projeto no qual um objeto delega o traba- 
lho a ser feito para algum outro objeto (o delegate propriamente dito). 
Uma das principais vantagens é que a classe pode delegar trabalho para 
algum outro lugar, melhorando a separação de responsabilidades e sem 
ter que ficar amarrada a uma determinada implementação. Delegates são 
utilizados frequentemente no desenvolvimento com Objective-C. 
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Para conectar o outlet o processo é o mesmo de sempre: com o Assistant Editor 
aberto, selecione o componente no Interface Builder, segure CTRL e arraste para o 
arquivo ViewController.h ao lado, e crie a connection Outlet com o nome “scroll”. 
Já conectar o evento de delegate envolve alguns passos a mais, mas embora possa 
parecer complicado numa primeira tentativa, é algo que rapidamente você dominará: 


e Primeiramente abra o “Document Outline” clicando na pequena seta que tem 
no canto inferior esquerdo, no Interface Builder 


e Selecione o scroll, então segure CTRL e arraste para cima do item “View Con- 
troller”, no Document Outline 


* No pequeno popup que aparecer, selecione a opção “delegate” 


e Feche o Document Outline, clicando na mesma seta usada para abri-lo 


Veja a figura 6.8 para referência. 
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Figura 6.8: Conectando o delegate do scroll view 


O que acabamos de fazer foi configurar o scroll view para que use a classe 
ViewController como sendo a responsável por lidar com os eventos do de- 
legate dele. Para finalizar esta parte da configuração, é necessário modificar 
o arquivo ViewController.h para que ele possa lidar com os eventos correta- 
mente. Para isso, modifique a declaração interface ViewController 

UlViewController para Ginterface ViewController : 
UlViewController<UlScrollViewDelegate>. 

Aproveitando que estamos mexendo no arquivo ViewController.h, declare uma 
variável de instância do tipo NsArray chamada elementos, e outra do tipo 
NSMutableArray chamada imagens, pois faremos uso delas logo mais. O código 
do arquivo deverá ficar assim: 


@interface ViewController : UlViewController<UlScrollViewDelegate> 


111 


6.6. Configurar os blocks de sucesso e erro do AFNetworking Casa do Código 





@property (retain, nonatomic) NSMutableArray *imagens; 
@property (retain, nonatomic) NSArray *elementos; 
OGproperty (weak, nonatomic) IBQutlet UIScrollView *scroll; 


Gend 


Agora temos diversas tarefas para fazer, de tal maneira que, ao iniciar, o aplicativo 
conecte-se a API do 500px, baixe as informações das últimas fotos postadas pelos 
usuários, e mostre-as em um scroll na medida que interagimos com ele. A lista de 
tarefas pode ser resumida desta maneira: 


e Configurar os blocks de sucesso e erro do AFNetworking 


e Configurar o scroll, para que tenha tamanho suficiente para comportar todas 
as imagens 


e Pré-gerar os componentes de imagens (porém sem carregá-las ainda) 
e Código para carregar uma determinada imagem 


e Carregar as outras imagens à medida que interagimos com o scroll 


6.6 CONFIGURAR OS BLOCKS DE SUCESSO E ERRO DO AF- 
NETWORKING 


A primeira parte do código ficará no método viewDidLoad, que é um método de- 
clarado na classe UlViewCont roller da qual a nossa classe ViewController herda 
(note que os nomes são muito parecidos, cuide para não fazer confusão). Ele é exe- 
cutado automaticamente pelo iOS assim que a view do controller é carregada em 
memória, portanto é um bom lugar para preparar o controller para uso, como inici- 
alizar variáveis, criar outras views auxiliares etc. 





LEMBRE-SE DOS IMPORTS 


Não esqueça de importar o arquivo AFNetworking.n, através da 














instrução fimport "AFNetworking.h" logo no início do arquivo 


ViewController.m 
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1 - (void) viewDidLoad 


2 { 


4 


19 
20 
21 
22 
23 
24 
25 


26 


7 } 


[super viewDidLoad]; 


NSString *url = O"http://bit.1ly/livroios-500px"; 
AFHTTPRequestOperationManager *manager = 
[AFHTTPRequestOperationManager manager]; 


manager.responseSerializer = [AFJSONResponseSerializer serializer]; 


[manager GET:url parameters:nil 
success :” (AFHTTPRequestOperation *operation, id json) 1 
“elementos = json[O"photos"]; 
[self mostraMensagem: [NSString 
stringWithFormat:0"Jd imagens encontradas", 


“elementos. count]]; 


if ( elementos.count > 0) { 
[self inicializaScroll]; 


} 
failure:^(AFHTTPRequestOperation *operation, NSError *error) { 
[self mostraMensagem: [NSString stringWithFormat:@"Erro: KO", 


[error localizedDescription]]]; 


1; 


A linha 9 configura o request para lidar com dados JSON, utilizando uma classe 


própria para isso do AFNetworking, a AFJSONResponseSerializer. Na linha 
12 declaramos o bloco de sucesso, sendo que o último parâmetro — id json — é 
o que conterá os dados do JSON em si, porém já convertidos para um NSDictionary 
pelo AFNetworking. Esta é a parte em que usar AFJSONResponseSerializeré 
vantajoso, pois caso contrário teríamos que lidar manualmente com alguma biblio- 
teca JSON. Na linha 13 pegamos todos os itens retornados pelo 500px, e guardamos 


para uso posterior na classe. 
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Como SABER O QUE TERÁ NO NSDICTIONARY? 


Dois detalhes importantes: primeiro, a declaração do bloco success 
passa o parâmetro “json” como sendo do tipo id, que é um tipo coringa. 
Se você conhece Java ou C#, é como se fosse o “Object” destas lingua- 
gens. Além disso, a documentação do AFNetworking não diz nada ex- 
plicitamente que o tipo passado será um NSDictionary, porém nos testes 
realizados foi este o caso, então assume-se que ao menos será um tipo 
compatível. Em segundo lugar, uma maneira fácil de descobrir a estru- 
tura dos dados no dicionário (que foi a usada a primeira vez que utili- 
zei a biblioteca) é simplesmente jogar o conteúdo no console, através de 
NSLog (@"%@", json). Como você pode ver, não há nenhuma “má- 
gica” envolvida, apenas um pouco de “programação orientada à tentativa 
e erro” 











O block failure, na linha 22, simplesmente mostra a mensagem de erro ao usuá- 
rio, caso a requisição falhe por qualquer motivo. 


6.7 CONFIGURAR O SCROLL E PRÉ-GERAR OS COMPONEN- 
TES DE IMAGENS 


O componente UIScrollView que adicionamos no arquivo Main.storyboard foi 
criado apenas com as configurações padrão, e agora vamos definir o tamanho da área 
em que o usuário poderá navegar, assim como adicionar as outras views que serão 
responsáveis por mostrar as imagens. Uma das propriedades mais importantes do 
UlScrollView éa contentsize, que especifica a largura e altura do conteúdo e que, 
dependendo dos valores informados e do tamanho da tela, permite que o usuário 
faça scroll para cima ou para baixo. O tipo da propriedade contentSize é CGSize, 
que é uma estrutura que comporta largura e altura, com ponto flutuante ( float), 
e é relativa ao tamanho do frame do scroll. Portanto, se o scroll tem 320x480 de 
tamanho, um contentSize com as mesmas dimensões não permitirá a rolagem do 
conteúdo, porém se o contentSize for de, digamos, 3200x500, será possível rolar uma 
grande quantidade na horizontal, e um pouco na vertical. Simples assim. 


- (void) inicializaScroll 1 
float largura = self.scroll.bounds.size.width; 
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float altura = self.scroll.bounds.size.height; 


self.scroll.contentSize = CGSizeMake(largura * elementos.count, 
altura); 
self.scroll.pagingEnabled = YES; 


“imagens = [[NSMutableArray alloc] init]; 


// Cria todos os lugares onde uma imagem pode 
// aparecer, para facilitar as coisas na hora 
// de carregar a imagem de fato do Flickr 

int indice = O; 


for (NSDictionary *item in elementos) { 
CGRect posicao = CGRectMake(indice++ * largura, O, largura, 
altura); 
UlImageView *img = [[UIImageView alloc] initWithFrame:posicao]; 


[ scroll addSubview: img]; 
[ imagens addObject: img]; 


// Adiciona a primeira imagem só para não ficar com a tela vazia 
[self carregaImagemRemota:0] ; 


} 


O código da linha 5 faz exatamente o que foi descrito no parágrafo anterior, defi- 
nindo a área de rolagem horizontal como sendo o tamanho do componente de scroll 
pelo número de imagens que temos. Além disso, queremos que o usuário possa ro- 
lar o conteúdo precisamente imagem por imagem, dando aquele efeito de que um 
simples arrastar já passe para a próxima imagem. Isso é feito com o código da linha 





6. Nos seus testes, mude o valor da propriedade pagingEnabled para NO e veja a 
diferença no comportamento da rolagem. 

O NSMutableArray iniciado na linha 8 será utilizado para termos acesso rá- 
pido e fácil a todos os componentes de imagens criados mais abaixo no método. 
Existem outras maneiras de obter o mesmo resultado sem precisar de uma variável 
auxiliar como estamos fazendo este caso, porém a abordagem mostrada neste exem- 
plo é bastante prática e não tem impactos significativos no uso da memória, pois 


apenas guardaremos referências. 
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Em iOS, sempre que você quiser mostrar uma imagem ao usuário, fará uso do 
componente UIImageView. Este componente, assim como todas views, precisa ser 
posicionado de maneira absoluta — não existe o conceito de posicionamento relativo 
em iOS. O código da linha 16 cria a posição onde cada imagem ficará, e na linha 17 
é criada a imageview em si. Se não tivéssemos a conta “ indice++ + largura” 
todas as imagens ficariam no mesmo lugar, se sobrepondo. A figura 6.9 demonstra 
este procedimento. 


contentSize: 1280px 
largura: 320px 


a [rem | mee mre 


Figura 6.9: Representação gráfica do posicionamento das imagens no componente 
scroll 





Como queremos que as imagens sejam roladas através do nosso componente 
scroll as adicionamos como filhas do mesmo, conforme o código da linha 19. 


6.8 CARREGAR UMA DETERMINADA IMAGEM 


No passo anterior configuramos o UIScrollView e já adicionamos todos os compo- 
nentes que irão carregar as imagens do 500px, deixando o terreno preparado para 
o momento de mostrar cada uma. Embora poderíamos criar cada UlImagemView 
somente quando o usuário chegasse no ponto do scroll em que ela fosse necessá- 
ria, isso demandaria um pouco mais de trabalho, além de correr o risco de causar 
aquele efeito de “travada” na interface. Porém, como não vamos mostrar milhares 
de imagens, pré-gerar facilita bastante as coisas. 
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- (void) carregaImagemRemota: (int) indice { 
NSDictionary *item = elementos [indice]; 
NSDictionary *imageInfo = item[O0"images"] [0]; 
NSString *url = imageInfo[O"url"]; 


NSLog(0"Carregando a URL %0", url); 


UlImageView *img = imagens [indice]; 
img.contentMode = UlViewContentModeScaleAspectFit; 
[img setImageWithURL: [NSURL URLWithString:url]]; 


O código da listagem acima recebe como argumento o índice da imagem a ser 
carregada, relativo ao conteúdo do array imagens, pega a URL do dicionário criado 
pelo AFNetworking lá no primeiro passo, e solicita o download e posterior exibição 
da imagem na tela. Na linha 8 pegamos a referência ao UllmageView criado no 
passo anterior, e informamos através da propriedade contentMode que a imagem 
deve ser renderizada de tal maneira que apareça por completo, porém respeitando 
as dimensões da tela e as devidas proporções. Sem esta propriedade, a imagem teria 
um aspecto “esticado”, fora das proporções originais. 

Uma parte interessante deste código está na linha 10, que utiliza mais um recurso 
do AFNetworking através do método set ImageWithURL:. Este método não existe 
na API padrão do componente UllmageView, mas o AFNetworking — por meio do 
recurso de “Categorias”, o qual é explicado em detalhes no capítulo sobre Objective- 
C — adiciona esta funcionalidade. Ela se encarrega de fazer o download da imagem 
em segundo plano (ou em “background”, no termo mais comum) e, caso ela já tenha 
sido baixada, de utilizar o cache local da mesma. Dessa forma, últimas chamadas a 
set ImageWithURL: com um mesmo endereço farão apenas um único download. 
Isso é uma grande mão na roda, pois se fossemos ter que fazer isso manualmente, o 


trabalho seria grande. 
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IMPORTAR A BIBLIOTECA AUXILIAR DE IMAGENS 


Para que o código compile corretamente é necessário importar al- 
gumas classes adicionais que vem junto com o AFNetworking. Vá ao 
menu “File -> Add files to VisualizadorImagens” e localize a pasta “UI- 
Kit+ AFNetworking” no diretório onde descompactou a biblioteca ante- 
riormente. 

Clique em “Add” e em seguida adicione a seguinte linha logo no início 
do arquivo ViewController.m: 


# import "UlImageView+rAFNetworking.h" 











6.9 CARREGAR AS OUTRAS IMAGENS À MEDIDA QUE INTE- 
RAGIMOS COM O SCROLL 


A última parte do código é responsável por carregar as demais imagens à medida 
que navegamos pelo scroll. O método scrollvViewDidScrol1: é um método es- 





pecial, especificado no UIScrollViewDelegate que declaramos no arquivo ViewCon- 
troller.h anteriormente. O UlScrollViewDelegate tem diversos métodos que podem 
ser implementados, como início e fim de zoom, animação e aceleração. O com- 
portamento do scrollViewDidScroll é ser executado diversas vezes, permitindo por 
exemplo que alguma ação (como carregar a imagem) seja feita enquanto o scroll está 
sendo rolado. Contudo, optamos por fazer esta tarefa apenas quando o usuário esti- 
ver “parado” em uma determinada posição: 


- (void) scrollViewDidScroll: (UIScrollView *)scrollView 1 
int x = (int)self.scroll.contentOffset.x; 
int largura = self.scroll.frame.size.width; 


// Somente carrega a próxima imagem 
// caso o scroll tenha parado em uma página 
if (x Y largura == 0) { 

int pagina = x / largura; 

[self carregaImagemRemota:pagina]; 
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A propriedade contentoffset, utilizada na linha 1, contêm a posição x e y em 
que a rolagem do scroll se encontra. Ela é do tipo CGPoint. Caso queira visualizar 
em detalhes os valores desta propriedade, você pode jogar no console desta forma: 


NSLog("contentOffset: %0", 
NSStringFromCGPoint (self .scroll.contentOffset)); 


Rode o aplicativo (Command + R)e navegue pelas fotos. O código completo do 
aplicativo encontra-se na pasta VisualizadorImagens. 


6.10 FAÇA SEU APLICATIVO FUNCIONAR EM TODAS AS ORI- 
ENTAÇÕES 


Um dos problemas que o nosso aplicativo tem é que, se você tentar girá-lo para a ori- 
entação landscape (ou “horizontal”, como muitas pessoas utilizam, especial leigos), 
verá que as coisas simplesmente ficam totalmente tortas, conforme mostra a figura 
6.10. 


iOS Simulator — iPhone Retina (3.5-inch) / iOS 7.0.3 (118508) 





Figura 6.10: Aplicativo com problemas para funcionar em landscape 
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SIMULANDO FUNCIONALIDADES DE UM DISPOSITIVO REAL 


O iOS Simulator que vem com Xcode funciona surpreendentemente 
bem, sendo inclusive possível simular diferentes orientações, Geoloca- 
lização e alertas de memória. Você encontra diversas opções no menu 
Hardware do simulador. Eis algumas comumente utilizadas: 


e Girar a tela para a esquerda: Command + Seta para 


esquerda 
e Girar a tela para a direita: Command + Seta para direita 
e Chacoalhar: CTRL + Command + Z 
e Tela em escala 100%: Command + 1 
e Tela em escala 725%: Command + 2 


e Tela em escala 50%: Command + 3 











Para solucionar o problema precisamos reorganizar as imagens depois que o apli- 
cativo mudar de orientação, posicionando-as no lugar correto. Isso é necessário por- 
que, quando iniciamos o aplicativo pela primeira vez, ele abre em portrait (ou “ver- 
tical”), e tanto o componente UIScrollView quando cada UIImageView nele 
adicionadas levam em consideração o tamanho da tela. Ao mudar a orientação, o 
tamanho da tela também muda, e temos que lidar com isso caso a caso. 

Vamos precisar de três coisas: uma variável de controle para sabermos qual 
é o índice da imagem sendo visualizada no momento, permitir a rotação para 
todas orientações, e lidar com o evento de rotação do dispositivo. Para a pri- 
meira parte, declare uma variável do tipo int no arquivo ViewController.h 
chamada paginaAtual. Em seguida, salve nela o valor passado ao método 


carregaImagemRemota:, conforme o pedaço de código abaixo: 


- (void) carregaImagemRemota: (int) indice { 
// Armazena o índice da imagem atual para usar no evento de rotação 
paginaAtual = indice; 
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5 


6 


7} 


// Restante do código já existente no método 


// 


« 


Para permitir rotação para todas as orientações, o método 





shouldAutorotate:” precisa retornar YES, conforme abaixo: 


(BOOL) shouldAutorotate { 


return YES; 


Agora precisamos reorganizar as imagens depois que a tela girar, e para isso basta 


sobrescrever o método didRotateFromInterfaceOrientation:: 


ı -(void) didRotateFromInterfaceOrientation: 


2 (UIInterfaceDOrientation)orientacao { 


3 


4 


float largura = self.scroll.frame.size.width; 
float altura = self.scroll.frame.size.height; 


int indice = 0; 


self.scroll.contentSize = CGSizeMake(largura * elementos.count, 
altura); 


for (UlImageView *img in self.scroll.subviews) { 
if (img.frame.size.width > 7 && img.frame.size.height > 7) { 
img.frame = CGRectMake(indice++ * largura, 0, largura, 
altura); 


CGPoint novaPosicao = CGPointMake (largura * paginaAtual, 0); 
[ scroll setContentOffset:novaPosicao animated:NOJ; 


Na linha 7 definimos o novo tamanho do scrol1, já que a largura e altura são 


diferentes em cada orientação. Já entre as linhas 9 a 13 iteramos por cada uma das 


subviews do scroll para colocá-las na nova posição. A condicional da linha 


10 não é exatamente uma boa prática, porém para efeitos de simplicidade da exem- 


plificação ela resolve o problema. Mais especificamente, as barras de rolagem que 


aparecem por padrão na UIScrollView são imagens também, com altura ou lar- 


gura de 7 pixels, mas queremos modificar apenas as fotos que vieram do Flickr. Na 


linha 10 calculamos a nova posição das fotos. 
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Por fim, o código das linhas 15 e 16 colocam o scro11 no lugar correto, levando 
em consideração o índice da última imagem visualizada. 

Rode o aplicativo novamente e gire a tela ( Command + Seta para direita) 
para ver o resultado. 
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CAPÍTULO 7 


Trabalhando com tabelas - 
UTTableView 


Apresentação de dados tabulares é uma das tarefas mais comuns que existem em 
qualquer plataforma, e no caso de iOS, sistemas inteiros podem ser desenvolvidos 
em cima desta forma de apresentação de dados, através da classe UlTableView. 
Podemos utilizar uma table view para as mais variadas tarefas: 


e Lista de países 

e Favoritos 

e Receitas 

e Opções de configuração 
e Lista de contatos 


e Números de telefone 


Casa do Código 





e Tarefas a serem realizadas 


A API deixa relativamente aberto o que podemos fazer com ela, embora a princí- 
pio não haja necessidade de muita customização — até porque precisamos levar em 
conta que o usuário estará usando um dispositivo móvel com os dedos, e não com 
um mouse. Em suma, a table view disponibiliza suporte a conteúdo adicionado em 
diversas linhas, que podem opcionalmente serem separadas em seções. Os próprios 
iDevices contam com diversos aplicativos construídos em cima de table views: Set- 
tings, Contacts, Reminders, favoritos do Safari, lista de álbuns do Photos e o próprio 
aplicativo da App Store. A figura 7.1 mostra alguns exemplos da UlTableView. 


NO F 


Categories 


iPhone 
Secrets 


ma 



















Using 3G loads data taster, but may 
decrease battery Kfe. 


Cellular Data Gr 


Tum off colular data to restrict all data to 
W-F including email, web browsing, and 
push notifications. 
Bluetooth o > 


T OFF 





Data Roaming Tunes Wi-Fi Sync > 






Tum off data roaming when traveling to 
avokki chargas when wod browsing arxi 
using email, MMS, and other data 
servicos. 


Spotlight Search > 


Caterinan Personal Hotspot Auto-Lock 1 Minute > E 


Figura 7.1: Diversas formas da UITableView 


Apesar de ter table no nome, o componente em si não atua como uma tabela de 
diversas linhas e colunas, mas sim apenas de diversas linhas, salvo pequenas custo- 
mizações que podem ser feitas. Certamente é possível criar células totalmente espe- 
cializadas, embora isso não seja muito comum por questões de usabilidade. Outro 
ponto importante é que, embora o conceito da UITableView seja bastante sim- 
ples, aprender a usar a API de maneira eficiente leva um certo tempo, como tudo 
relacionado à programação para iOS. Lembro que as minhas primeiras experiências 
com este componente não foram das mais agradáveis justamente porque fiquei in- 
sistindo em querer entendê-lo e usá-lo à força, o que foi algo um tanto traumático. 
Conheça-o aos poucos, como faremos aqui. 

O código-fonte deste capítulo está disponível nas pastas “ 
TableViewDelete” e 
TableViewMultipleDelete” (lembrando que o endereço do site com os 


« « 


TableViewSimpleContactList” 
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códigos está na introdução do livro). 


7.1 CRIANDO A PRIMEIRA TABLE VIEW - CONCEITOS E 
EXEMPLO 


Ok, se você não desistiu de ler, então ainda há esperança. Lembre-se sempre: a curva 
inicial de aprendizado da table view é um pouco íngreme, mas depois tudo fica bas- 
tante claro e fluído. Justamente por este motivo é muito importante que não pule esta 
pequena parte conceitual (afinal, o ávido aprendiz quer ver algo funcionando logo, 
certo?). 

Para funcionar, a table view precisa sempre que dois tipos de delegates sejam 
implementados: O UITableViewDataSource, o qual provê os dados e informa- 





ções estruturais gerais paraa UlTableView,e UlTableViewDelegate, o qual é 
responsável por lidar com eventos de integração e customizações de cada linha. As 
principais responsabilidades de cada um são: 


A fonte de dados - UlTableViewDataSource 


O data source é o protocolo que fornece os dados de fato para a table view, e o 
único que tem alguns métodos de implementação obrigatória pelo compilador. 


e Número de seções da tabela 
* Número de linhas (obrigatório) 


e Eventos de reordenação, inserção e seleção de dados 


Título do cabeçalho e rodapé 


* Fornecer o conteúdo em si de uma determinada linha (obrigatório) 


Configurações e ações - UITableViewDelegate 





Emborao UlTableViewDelegate não tenha nenhum método de implemen- 
tação obrigatória, é com ele que de fato interagimos com a table view em si. 


e Altura da linha 


e Lidar com interação (toque) de uma determinada linha 
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e Lidar com a edição de alguma linha 


Estas são os principais eventos que precisamos implementar, independente- 
mente do tipo de conteúdo que será apresentado na table view, pois eles são os pilares 
para o correto funcionamento. Não espero que você consiga se lembrar sempre de 
cabeça quais são as assinaturas de todos os métodos que devem ser implementados 
para colocar uma table view para funcionar — eu mesmo não lembro de tudo até 
hoje. O importante é você saber o que deve ser feito, como fazer e, talvez o mais 
importante de tudo, saber onde encontrar a documentação no caso de dúvidas. 

A principal intenção do primeiro exemplo no qual trabalharemos — uma lista 
de contatos — é focar na forma de criação e organização do código necessário para 
tera UlTableView funcionando. Se em algum momento você pensar “.. mas isso 
é muito código para pouca coisa..., lembre-se que a table view precisa de um con- 
junto mínimo de informações para funcionar, independentemente se mostraremos 
um único registro ou um milhão. A figura 7.2 mostra a aplicação depois de finalizada. 





Lista de contatos 
Fernando Afonso 
Bia Maria 
Pedro Cardoso 


Ana Maria Contato 
Nome: Bia Maria 


Francisco Chico Telefone: 9999-9999 


Paulo José OK 


Marco Antonio 


Ana Sophia 


João Pedro 


Maria Julia 





Figura 7.2: Primeiro exemplo com UlTableView 
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7.2 O APLICATIVO DE LISTA DE CONTATOS 


Começaremos com um novo exemplo, para depois você praticar com o nosso catá- 
logo de empresas. 

O aplicativo que criaremos a seguir consiste em uma hipotética lista de contatos, 
que mostra o nome e o telefone de um determinado item quando algum elemento 
da tabela recebe o evento de toque. Para começar, crie um novo projeto do tipo Sim- 
ple View Application chamado “TableViewSimpleContactList”, utilizando as opções 
padrão. Feito isso, siga os passos abaixo: 


1) Abra o arquivo Main.storyboard; 
2) Insira um Label centralizado no topo, com o texto “Lista de contatos”; 


3) Adicione o componente “Table View” logo abaixo do label, redimensionando-o 
para ocupar o resto do espaço da tela; 


4) Com o Assistant Editor aberto (View -> Assistant Editor -> Show Assistant 
Editor), clique em cima do componente table view, segure CTRL e arraste o 
mouse para o arquivo ViewController.h, inserindo uma Connection do tipo 
Outlet chamada tabelaContatos (obs: se ocorrer do Xcode mostrar o arquivo 
.m, certifique-se primeiro de alternar para o .h utilizando a barra superior. Você 


deverá ver o nome do arquivo nela ); 


5) Agora clique com o botão direito em cima do componente table view para abrir o 
menu de opções, e arraste a bolinha dos outlets datasource e delegate para 
o ViewController, que é representado por um círculo amarelo. Veja a figura 7.3 
para referência; 


6) Para que a nossa classe ViewController receba os eventos da table 
view, é necessário ainda especificar os protocolos UlTableViewDelegate e 





UITableViewDataSource na declaração da Ginterface; 


7) Por último, precisamos de um array para armazenar os contatos que serão carre- 
gados de um arquivo de configuração. Para isso, declare um membro de instância 
do tipo NSMutableArray chamado contatos. 
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View Controller 


Figura 7.3: Conectando as propriedades datasource e delegate 


Veja na listagem abaixo como deverá ficar o seu arquivo ViewController.h: 


t import <UIKit /UIKit.h> 


Ginterface ViewController : UlViewController<UlTableViewDataSource, 
UITableViewDelegate> 1 
NSMutableArray *contatos; 


} 
@property (weak, nonatomic) IBQutlet UITableView *tabelaContatos; 


Gend 


7.3 CARREGANDO OS CONTATOS A PARTIR DE UM ARQUIVO 
PLIST 


A UlTableView não impõe quaisquer restrições de onde os dados deverão vir, o 
que é excelente. Ela apenas pede “por favor, me forneça os dados da linha X”, e aí 
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fica a nosso cargo buscar tal informação onde quer que seja. No caso do aplicativo 
de lista de contatos, as informações estão em um arquivo plist, ou “Property List” 
(particularmente pronuncio como “pê list”), que é um formato relativamente comum 
em aplicações Mac e iOS para armazenar coisas simples. Na prática, nada mais é que 
um documento XML com algumas tags específicas. Sua utilidade é como a de um 
dicionário (chave e valor), com a diferença de que é possível especificar o tipo de 
dados. 

Crie o arquivo contatos.plist em File -> New -> File... -> Resource -> Pro- 
perty List, e abra-o no Xcode. Existem três colunas: Key, que obviamente é o nome 
da chave do dicionário, Type para informar o tipo de dados (dicionário, array, nú- 
mero, string, data, booleano ou conteúdo “genérico”), e Value, que é o valor da chave 
de fato. 

Logo após criar o arquivo, você verá que existe uma chave chamada “Root” do 
tipo “Dictionary”, e o conteúdo que formos adicionar deverá ser filho desta chave. 
Clique com o botão direito e selecione a opção “ Add Row”, e em seguida nomeie 
“contatos” e selecione “ Array” como “Type”. Cada um dos elementos deste array 
será outro dicionário contendo as chaves “nome” e “telefone”, os quais iremos ler e 
organizar em uma estrutura de dados especializada na hora em que o aplicativo for 
iniciado. 

Clique com o botão direito em cima de “contatos” e selecione Add Row. A Key do 
item pode ser qualquer coisa (usei “Item o”, “Item 1” etc.), enquanto que o Type deve 
ser configurado para Dictionary. Insira duas chaves do tipo String, uma para 
o nome e outra para o telefone do contato. Repita a operação até cansar. A figura 7.4 
mostra como deverá ficar o seu arquivo. 
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Key 
contatos 
vitem O 
nome 
telefone 
viteml 
nome 
telefone 
¥item 2 
nome 
telefone 
> Item 3 
> Item 4 
> Item 5 
> Item 6 
> Item 7 
> Item 8 
> Item 9 
> Item 10 
> Item 11 





Figura 7.4: Organização do arquivo contatos.plist 


oo 


Type 
Array 


Diction.. 


String 
String 


Diction... 


String 
String 


Diction... 


String 
String 


Diction... 
Diction... 
Diction.. 
Diction... 
Diction... 
Diction.. 
Diction... 
Diction... 
Diction.. 


<» 


Value 

(12 items) 
2 it ; 
Ana Sophia 
1111-1111 


t 


Maria Julia 
2222-2222 


it 


João Pedro 
3333-3333 








a opçõa desejada. 


CORRIGINDO O ANINHAMENTO 


Caso os elementos não estejam sendo criados na hierarquia esperada, 
é possível aninhá-los com o item de menu “Shift Row Right” para tornar 
o elemento filho do que se encontra logo acima, e “Shift Row Left” para a 
operação contrária. Clique com o botão direito no elemento e selecione 








Para carregar o conteúdo do arquivo usamos a classe NSDictionary, e na prá- 


tica isso já seria suficiente para trabalharmos com a table view. Porém, dicionários 
com muitos dados são chatos de trabalhar e muito suscetíveis a erros de digitação. 


O ideal, portanto, é utilizar uma estrutura de dados especializada, e “transformar” o 


dicionário em instâncias desta estrutura. Crie uma nova classe chamada Contato 
com duas propriedades do tipo NSString (já que as chaves no property list são 
“strings”) chamadas nome e telefone, conforme o código abaixo do Contato. h: 


t import <Foundation /Foundation.h> 
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Qinterface Contato : NSObject 
-(id) initWithNome: (NSString *) nome andTelefone: (NSString *) telefone; 


Oproperty (nonatomic, retain) NSString *nome; 
@property (nonatomic, retain) NSString *telefone; 


@end 


E aqui do Contato.m: 


* import "Contato.h" 
Cimplementation Contato 
- (Cid) initWithNome: (NSString *) nome andTelefone: (NSString *) telefone { 


if ((self = [super init])) { 
self .nome = nomelInicial; 
self .telefone = telInicial; 


return self; 


@end 


Já temos pronto a lista de contatos em um arquivo próprio e a estrutura de da- 
dos Contato para representar no código cada registro daquele arquivo. O pró- 
ximo passo consiste, portanto, em juntar estes dois pedaços, carregando o conteúdo 
do arquivo contatos.plist em memória, armazenando os registros na variável 
contatos. Confira abaixo o método loadContacts, que deve ser implementado 
no arquivo ViewController.m: 


- (void) loadContacts 1 
NSString *plistCaminho = [[NSBundle mainBundle] 
pathForResource:0"contatos" ofType:O"plist']; 
NSDictionary *pl = [NSDictionary 
dictionaryWithContents0fFile:plistCaminho]; 
NSArray *dados = [pl objectForKey:O"contatos"]; 
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contatos = [[NSMutableArray alloc] init]; 


for (NSDictionary *item in dados) 1 
NSString *nome = [item objectForKey:O"nome"]; 
NSString *telefone = [item objectForKey:O"telefone"]; 


Contato *c = [ [Contato alloc] initWithNome:nome 
andTelefone: telefone]; 
[contatos addObject:c]; 


Obs: não se esqueça de importar o header de Contato, com a instrução timport 


"Contato.h" logo no início do arquivo 


Como para fins práticos para o iOS um arquivo Property List é um dicionário, 
carregá-lo em memória é bastante simples, conforme a linha 4: basta iterar pelos 


registros transformando-os em Contatos. 
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A CLASSE NSBUNDLE 


A classe NSBundle contém métodos para encontrar e carregar coisas 
que façam parte do pacote do seu aplicativo. Por exemplo, o método 
pathForResource: utilizado em loadContacts procura o arquivo 


especificado a partir da raiz do projeto. 











Para que o método seja executado ao iniciar o aplicativo, chame-o no método 


viewDidLoad, conforme abaixo: 


- (void)viewDidLoad { 
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NOME DAS VARIÁVEIS NO MÉTODO INITWITHNOME 


Algumas pessoas irão reparar que as variáveis do mé- 
todo initWithNome tem o mesmo nome das @property. 
Para evitar conflitos em casos como esse, usa-se a instrução 
self.nome e  self.telefone para referenciar os membros 
da classe. Algumas pessoas preferem utilizar underline nes- 
tas situações, como initwithNome: (NSString +) | nome 
andTelefone: (NSString +) telefone, mas isso é algo comple- 
tamente de gosto pessoal. 











7.4 TORNANDO A TABELA FUNCIONAL 


Agora que já temos a estrutura geral do aplicativo construída, incluindo a lista de 
contatos que deverá ser apresentada ao usuário, é hora de fazer as partes específicas 
da table view, que são três. Teremos de informar quantos itens temos para mostrar, 
fornecer os dados de cada um dos contatos para cada linha e lidar com o evento de 
toque em um determinado contato. 


Os dois primeiros itens fazem parte do protocolo ULTableViewDataSource, 





enquanto o terceiro pertencea UlTableViewDelegate. E como eu sei isso? Fácil, 
lendo a documentação. Depois de algum tempo você provavelmente irá se lembrar 
de memória o que fica em qual lugar, portanto não se preocupe demais em querer 
decorar tudo — apenas lembre-se sempre: se não souber onde está algo, acesse a 
documentação. 
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ACESSANDO A DOCUMENTAÇÃO DA API PELO XCODE 


Existe uma maneira bem fácil e prática de acompanhar e acessar a do- 
cumentação da API do iOS diretamente pelo Xcode, através do inspetor 
Quick Help, conforme mostrado na figura 7.5. Para habilitar, vá no menu 
View -> Utilities -> Show Quick Help Inspector, e aparecerá um painel 
com uma breve descrição da classe onde o cursor do mouse se encontra, 
no editor de códigos. 


















eoe E TableViewSimpleContactList.xcodeproj — m} ViewController.m = 
x ' ~ ) 
Build Succeeded Today at 8:07 PM =] E 1 1 =] 
(>) (m) (T.>iPhon.. ) (mo) | Elo aJ(o (3) 
Run Stop Scheme Breakpoints mts Editor Organizer 
m| < > i TyTableviewSimpleContactList ) C]T..) [m] ViewController.m > [X] -tableview-numberOfRowsinSection: nie! 
{BOOL }shouldAutorotateToInterface0rientation: (UlInterfaceOrientation) Quick Help 
interfaceOrientation { 
return UlInterfaceOrientationTsPortrait(interfaceOrientatíon); 1 Name UTableView 
} Availability: iOS (2.0 and later) 
dt Abstract: An instance of UlTableVily (or 
tu oididea toc { simply, a table view) is a means for 
t da i E displaying and editing hierarchical lMg of 
[tabelaCon release); information. 


[su ealtoc]; 
p Sr dealloc]; Declared In: UlTableView.h 2 


Reference: UlTableView Class Reference 
Related Documents: Table View Programming 








sinil]; Guide for iOS 
Sample Code: DrillDownSave, LocateMe, 
3 TableViewSuite, TheElements, 
PhoneCoreDataRecipes 
P ark UITableViewData 
leView: (UlTabjleViem, +)tableView numberOfRowsInSection: (NSInteger) 








D Gjel æ 
Wj objects :) (2288) 


Table View - Displays data in a list of 
plain, sectioned, or grouped rows. 





tos. count; 


- (UITableViewCell e)tableView: (UITableView e)tableView celiForRowAtIndexPath: 
(NSIndexPath ejindexPath { 
static NSString eCellId E"ContactCell"; 
UlTableViewCell ecell = tabelalon s dequeueReusableCelINithIdentifier:CellId 
i Table View Cell - Defines the 
attributes and behavior of cells (rows) in 
if (cell) { à table view 
cell = [[[VIT € alloc] 


initwiths viewCeliStyleDefault 
reuseldentifier:CellId] autorelease); Table View Controller - A controller 


that manages a table view. 








antatos abjectAtIndex: indexPath. row]; 
nome; © Table View 


Figura 7.5: Funcionamento do painel de ajuda rápida 











7.5 INFORMANDO A QUANTIDADE DE ITENS QUE TEMOS 


A primeira coisa a fazer é informar quantas linhas a table view deverá ter, conforme 
o código a seguir: 
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- (NSInteger)tableView: (UITableView *)tableView 
number0fRowsInSection: (NSInteger)section { 


return contatos.count; 


7.6 EXIBINDO DADOS EM CADA LINHA 


O componente UlTableView utiliza uma abordagem um pouco diferente para exi- 
bir registros, na qual — ao invés de montarmos as linhas com tudo o que a tabela 
deverá conter — é preciso entregar registro por registro de maneira indireta, dei- 
xando a cargo da table view o trabalho de construir as linhas e gerenciar memória e 
performance. Em outras palavras, é a table view quem solicita o que deve exibir em 
uma determinada linha, fazendo uso do método cellrorRowAt IndexPath defi- 
nido no protocolo UlTableViewDataSource (lembre-se: “datasource” significa, 
literalmente, “fonte de dados” em português). 

O código abaixo faz exatamente isso: implementamos o método do datasource, 
o qual nos passa o índice do elemento desejado, de tal forma que a célula da table 


view contenha como texto o nome do contato. 


- (UlTableViewCell *)tableView: (UITableView *)tableView 
cellForRowAt IndexPath: (NSIndexPath *)indexPath { 


static NSString *CelulaContatoCacheID = O0"CelulaContatoCacheID"; 
UlTableViewCell *cell = [self.tabelaContatos 
dequeueReusableCellWithIdentifier:CelulaContatoCacheID] ; 
if (!cell) 1 
cell = [[UITableViewCell alloc] 


initWithStyle:UlTableViewCellStyleDefault 
reuseldentifier:CelulaContatoCacheID] ; 


Contato *contato = [contatos objectAtIndex: indexPath.row]; 
cell.textLabel.text = contato.nome; 


return cell; 


Rode o aplicativo (Command + R,ou Product -> Run) e veja os contatos apare- 
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cerem na tabela. Toque em alguns registros também. Acontece alguma coisa? Vere- 
mos logo mais como implementar esta parte. 

Existem alguns conceitos importantes na forma de construção deste código, 
sendo o principal deles em relação a performance. Para entender melhor, considere 
que a UlTableView é um componente que pode ser utilizado para uma infini- 
dade de situações, apresentando ao usuário uma quantidade ilimitada de elementos. 
Como o aplicativo roda em dispositivos móveis onde os recursos de hardware são 
mais limitados — especialmente memória —, é de vital importância que façamos 
uso de mecanismos para reaproveitar algumas coisas. Embora fosse possível fazer o 
código da listagem anterior de maneira mais simples, o mesmo pode eventualmente 
ser péssimo em termos de performance. 





TESTANDO QUESTÕES DE PERFORMANCE NO SIMULADOR VER- 
SUS NO DEVICE 


O iOS simulator é uma excelente ferramenta para auxiliar o desen- 
volvimento de aplicativos, pois evita que tenhamos que fazer deploy di- 
retamente em algum dispositivo. Porém, algumas coisas — como o com- 
passo ou eventos de inclinação — não podem ser simuladas nele, e ou- 
tras, como memória e processador, são irreais, uma vez que o simulador 
roda sob o Mac OS X. Portanto, a única maneira de saber como o apli- 
cativo se comporta com muita informação e até mesmo para saber se as 
animações estão fluídas, é testar diretamente no device. 











Para auxiliar neste quesito, a ULTableView nos fornece a opção de reutilizar as 
UlTableViewCel1s que pertençam a uma mesma categoria de dados (o que deve 
representar a maior parte dos casos em seus aplicativos), o que é feito nas linhas 5 
e 6 com o método dequeueReusableCellWithIdentifier:. Ele recebe um 





identificador que é utilizado internamente para pegar cells de um cache sempre que 
possível. No caso do nosso aplicativo, o identificador é aquele representado pelo có- 
digo da linha 4, que chamamos de CelulaContatoCacheID, que é um valor arbitrário, 
sem nenhum significado especial. 

Caso você esteja se perguntando se existe a possibilidade de ocorrer algum tipo 
de problema com esta abordagem de reutilização de células, a resposta é “talvez”. 
Ou seja, se partirmos do princípio que ao invés de criar 1000 instâncias da célula a 
tabela cria apenas 20 e as reutiliza para todo o conjunto de dados, é responsabilidade 
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do programador garantir que todas as propriedades relevantes sejam preenchidas, 
caso contrário o valor definido por quem utilizou a célula por último será exibido. 
Faça um teste e comprove você mesmo. 

Na linha 10 iniciamos a célula com o estilo padrão ( 
UlTableViewCellStyleDefault), o qual mostra uma linha de texto ape- 





nas, que é aquele atribuído na linha 15. As outras opções são as listadas abaixo, e na 
figura 7.6 há uma demonstração de cada um dos estilos. 


e UlTableViewCellStyleSubtitle: Título em negrito alinhado no canto 





superior esquerdo, e um subtítulo cinza alinhado no canto inferior esquerdo, 





acessível pela propriedade detailTextLabel 


e UITableViewCellStyleValuel: Texto na cor preta alinhado à esquerda, 





e um outro texto na cor azul alinhado à direita, acessível pela propriedade 
detailTextLabel 





e UlTableViewCellStyleValue2: Texto da propriedade textLabel à es- 








querda e na cor azul, e o valor da propriedade detailText Label à direita 
na cor preta 


UlTableViewCelIStyleSubtitle 
Maria Julia 
João Pedro 


UlTableViewCelIStyleValue1 


Maria Julia 2222-2222 


João Pedro 3333-3333 


UlTableViewCelIStyleValue2 
Maria Julia 2222-2222 


João Pedro 3333-3333 


Figura 7.6: Os diferentes estilos pré-configurados de uma UlTableViewCell 
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7-7 PERMITINDO INTERAÇÃO COM OS ITENS DA TABELA 


Toda vez que o usuário toca em uma linha da table view, o método 
didSelectRowAtIndexPath: é disparado, dando-nos a chance de realizar 
alguma ação — que no nosso caso será mostrar uma mensagem utilizando 
UlAlertView. Como muitos dos outros eventos da table view, este método recebe 
o índice da linha selecionada, que usaremos para pegar o respectivo registro na 


variável contatos: 


1 - (void)tableView: (UITableView *)tableView 
2 didSelectRowAtIndexPath: (NSIndexPath *)indexPath 1 


4 Contato *contato = [contatos objectAtIndex:indexPath.row]; 

5 NSString *msg = 

6 [NSString stringWithFormat:0"Nome: %0\nTelefone: KO", 

7 contato.nome, contato.telefone]; 

8 

9 UlAlertView *alert = [[UIAlertView alloc] initWithTitle:O"Contato" 
10 message:msg 

u delegate:nil 

12 cancelButtonTitle:0"0K" 

13 otherButtonTitles:nil]; 

14 [alert show]; 

15 

16 [self .tabelaContatos deselectRowAtIndexPath:indexPath animated:YES]; 
v + 


O código da linha 13 faz com que a linha automaticamente perca a seleção após 
a interação (remova a linha e veja o que acontece). Rode novamente o aplicativo e 


interaja com os registros. 


7.8 REMOVENDO ELEMENTOS DA TABLE VIEW 


Em aplicativos iOS, uma operação que os usuários estão acostumados a fa- 
zer é realizar o movimento de swipe da direita para esquerda (ou, tecnica- 
mente um swipe left), que é aquele movimento de deslizar rapidamente o 
dedo no eixo horizontal. Tanto por conveniência quando para manter um 
comportamento padrão nos aplicativos a UlTableView (através do delegate 
UlTableViewDelegate) já disponibiliza tal funcionalidade, bastando implemen- 
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tarmos o método tableView:commitEditingStyle:forRowAtIndexPath: 





conforme abaixo: 


- (void) tableView: (UITableView *)tableView 
commitEditingStyle: (UITableViewCellEditingStyle)editingStyle 
forRowAt IndexPath: (NSIndexPath *)indexPath { 


[contatos removelbjectAtIndex: indexPath.row]; 
[self .tabelaContatos reloadData] ; 


O funcionamento é o seguinte: o iOS verifica se existe a implementação deste 
método na nossa classe, e caso positivo, habilita a operação de swipe left para remover 
alguma linha, invocando o método em si quando o usuário interage com o botão. 


Veja na figura 7.7 o resultado. 


iOS Simulator - iPhone Retina (3.5-inch) / iOS 7.0.3 (118508) 





Carrier > 


Bia Maria 
ardoso 


Ana Maria 


Paulo José 


Ana Sophia 


João Pedro 


Maria Julia 





Lista de contatos 


Fernando Afonso 


Francisco Chico 


Marco Antonio 


9:11 PM = 





Figura 7.7: Interface padrão do botão deletar 
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Note que o texto padrão no botão está em inglês. Para 
especificar outro texto, temos que implementar o método 
tableView:titleForDeleteConfirmationButtonForRowAtIndexPath: 


-(NSString *) tableView:(UITableView *)tableView 
titleForDeleteConfirmationButtonForRowAtIndexPath: 
(NSIndexPath *)indexPath { 
return @"Remover"; 


79 REMOVENDO DIVERSAS LINHAS 


Uma outra maneira de remover registros é aquele em que o usuário toca em um 
botão Editar e a table view mostra uma série de pequenos botões redondos com um 
símbolo de subtração, conforme mostrado na figura 7.8. Para obter este resultado, 





adicione um botão na interface chamado botaoEditar, e conecte uma ação a ele 





chamada botaoEditarTap, onde iremos enviar uma mensagem à tabela para que 
ela entre em modo de edição. Por último, especificamos o tipo de operação a ser feito 
em cada uma das linhas. 


140 


Casa do Código Capítulo 7. Trabalhando com tabelas - UlTableView 








PASSOS PARA ADICIONAR O BOTÃO 


Caso tenha ficado na dúvida, os passos são esses: abra o arquivo 
Main.storyboard, adicione um componente “Button” ao lado do la- 
bel “Lista de contatos” ative o Assistant editor, certifique-se que 
o arquivo ViewController.h esteja selecionado no painel da direita, 
CTRL+clique e arraste do botão para o arquivo .h para criar um Outlet 
com o nome de “botaoEditar”, e em seguida mais um CTRL+clique e ar- 
raste para criar uma Action com o nome “botaoEditar Tap”. 

O código do arquivo “ViewController.h” deverá estar assim: 


# import <UIKit /UlKit.h> 


Ointerface ViewController : UlViewController<UITableViewDataSource, 
UlTableViewDelegate> { 
NSMutableArray *contatos; 


} 

@property (weak, nonatomic) IBOutlet UIButton *botaoEditar; 
@property (weak, nonatomic) IBQutlet UITableView *tabelaContatos; 
- (IBAction)botaoEditarTap: (id)sender; 


@end 











Confira o código abaixo: 


ı // Executado quando o usuário toca no botão Editar 
2 - (IBAction)botaoEditarTap: (id)sender { 


3 


4 


5 


if ([self .botaoEditar.titleLabel.text isEqualToString:O"Editar"]) 1 
[self .tabelaContatos setEditing:YES animated:YES]; 
[self .botaoEditar setTitle:0"Pronto" 
forState:UlControlStateNormal]; 


} 
else { 
[self .tabelaContatos setEditing:NO animated:YES] ; 
[self .botaoEditar setTitle:O"Editar" 
forState:UlControlStateNormal]; 
F 
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// Tipo de operação a ser feita. Neste caso em específico, 
// queremos permitir apenas a remoção de elementos 
// (é possível inserir novos também) 
- (UlTableViewCellEditingStyle) tableView: (UlTableView *)tableView 
editingStyleForRowAtIndexPath: (NSIndexPath *)indexPath 1 
return UlTableViewCellEditingStyleDelete; 





O código do método botaoEditarTap: não tem muito mistério, sendo que 
a ação de colocar a table view em modo de edição e sair dele é feito nas linhas 4 e 
8 respectivamente. De resto, verificamos o texto do botão para alterar a mensagem 
mostrada ao usuário. Já na linha 17 informamos explicitamente que a única operação 
que queremos permitir é a de remoção de elementos — a outra possível é inserir 
novos registros. O resto do trabalho é feito pelo código visto nos exemplos anteriores. 


| iOS Simulator - iPhone Retina (3.5-inch) / iOS 7.0.3 (118508) 
Carrier > 9:22 PM md 
Lista de contatos Pronto 





@ Fernando Afonso 
O Bia Maria 
Cardoso 
Ana Maria 
Francisco Chico 
Paulo José 
Marco Antonio 
Ana Sophia 


João Pedro 








Maria Julia 
C 


Figura 7.8: Removendo múltiplas linhas 
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7.10 CRIE UMA TABELA PARA O NOSSO CATÁLOGO DE EM- 
PRESAS 


Eis um desafio: utilizar os conhecimentos aprendidos até agora para modificar o apli- 
cativo de catálogo de empresas feito no capítulo 3, para que a listagem das empresas 
seja mostrada em uma table view ao invés de exibir apenas no console. A ideia é 
que, após clicar no botão salvar, o atual método mostraCatalogo apresentado na 
seção 3.16 instancie um novo controlador, o qual receberá como argumento a lista 
de empresas disponíveis na variável catalogo, e construirá a table view com os 
dados. Utilize o UlNavigationController (apresentado no capítulo 4) para ir 
de um controlador para outro. 

Como ponto de partida, você pode seguir os seguintes passos: crie uma nova 
classe chamada “ExibeCatalogoController” que estenda UlViewCont roller, uti- 
lizando a opção de criar o arquivo .xib conjuntamente. Adicione um compo- 





nente UlTableView e conecte-o ao arquivo ExibeCatalogoController.h, 
aproveitando para declarar também uma @property para a variável catalogo 
que será passada pela outra classe. Não esqueça de informar os protocolos 
UlTableViewDataSource e UlTableViewDelegat 





O esqueleto mínimo da nova classe deverá se parecer com o código abaixo: 


// ExibeCatalogoController.h 
# import <UIKit /UlKit.h> 


Qinterface ExibeCatalogController : 
UlViewController<UlTableViewDelegate, UlTableViewDataSource> 


Oproperty (weak, nonatomic) IBQutlet UlTableView *tabela; 
@property (nonatomic, assign) NSArray *catalogo; 


@end 
// EribeCatalogoController.m 
#import "ExibeCatalogController.h" 


#import "Empresa.h" 


@implementation ExibeCatalogController 
@synthesize tabela, catalogo; 


- (NSInteger)tableView:(UITableView *)tableView 
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number0fRowsInSection: (NSInteger)section 1 


return self.catalogo.count; 


- (UlTableViewCell *)tableView: (UITableView *)tableView 
cellForRowAt IndexPath: (NSIndexPath *)indexPath { 


return nil; 


} 
@end 


Já no método mostraCatalogo, chame o novo controlador desta forma: 


- (void) mostraCatalogo { 
ExibeCatalogController *c = [[ExibeCatalogController alloc] init]; 
c.catalogo = catalogo; 
[self .navigationController pushViewController:c animated:YES]; 


Boa sorte! Toda informação de que você precisa está nos capítulos apresentados 
até agora no livro. 


144 


CAPÍTULO 8 


Trabalhando com reconhecedores 
de gestos 


Diferentemente de aplicativos que são feitos para serem utilizados em computadores 
com mouse e teclado físicos, a interação com o iOS dá-se unicamente por diversos 
tipos de toques na tela, indo muito além do que é possível fazer apenas com um 
mouse. A operação mais padrão e natural é a de tocar uma única vez na tela como se 
estivéssemos clicando. É algo tão simples que não precisa de maiores explicações — 
uma criança de 1 ano de idade ou uma pessoa de 95 anos sem afinidade tecnológica 
se sairá muito bem com esta operação. 

Em contrapartida, existem uma série de outras interações que requerem um 
pouco mais de trabalho para interpretar corretamente, como deslizar o dedo (swipe), 
tocar e segurar (long press), movimento de pinça (pinch), dois toques (double tap) e 
o que mais a imaginação permitir. 

Existem duas maneiras de lidar com eventos de toque: trabalhando com o sis- 
tema em mais baixo nível, que permite o máximo de customização (e também requer 
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muito mais trabalho para implementar), e os reconhecedores de gestos, que são al- 
gumas classes prontas para as operações mais comuns. 

O código-fonte deste capítulo está disponível nas pastas “GestoSwipe” “TapCir- 
culos”, “TremeTreme” e “View TouchEventEx1” (lembrando que o endereço do site 


com os códigos está na introdução do livro). 


8.1 SISTEMA DE EVENTOS TRADICIONAL 


O sistema de eventos tradicional — assim chamava a única abordagem que existia até 
o iOS 3.2 — consiste no trabalho conjunto de uma série de métodos que, embora mais 
trabalhosos de implementar, permitem o máximo de customização na maneira como 
os toques que o usuário faz na tela são interpretados. Todos os métodos pertencem à 
classe ULView (mais precisamente, pertencem a UIResponder, de quem UIView 
herda) e podem ser sobrescritos conforme forem necessários. Os principais são: 








— (void) touchesBegan: (NSSet +)touches withEvent: (UlEvent 


*)event 








- (void) touchesMoved: (NSSet *+)touches withEvent: (UlEvent 


*)event 























— (void) touchesEnded: (NSSet *+)touches withEvent: (UlEvent 


*)event 





e — (void) touchesCancelled: (NSSet +)touches 











withEvent: (UlEvent +)event 


O método touchesBegan ocorre quando o usuário inicialmente toca a 





tela, e o touchesEnded é disparado quando o usuário remove o dedo. Já 
touchesCancelled é disparado pelo iOS quando alguma coisa ocorre em algum 
lugar que obriga os eventos de toque a serem cancelados — os motivos variam bas- 
tante. Por último, touchesMoved serve para lidarmos com os casos onde o usuário 
arrasta o dedo pela tela. 
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INTERAÇÃO COM COMPONENTES COMUNS DO DIA A DIA 


Algo importante a ressaltar é que toda informação deste capítulo 
aplica-se a views customizadas que construímos. Os componentes pa- 
drão do dia a dia, como UlIButton, UlTableView, UlTextView e 
afins já têm os seus próprios mecanismos para lidar com interações do 
usuário. As possibilidades de customização que são apresentadas aqui 
são um mecanismo para casos especiais. 











Para melhor demonstrar como lidar com estes eventos, vamos fazer um aplica- 
tivo que desenha círculos vermelhos em cada região de toque. Crie um novo projeto 
chamado “View TouchEventEx1” e logo em seguida adicione uma nova classe cha- 
mada CirculoView, que herda de UIView (File -> New -> File -> Cocoa Touch -> 
Objective-C Class -> Subclass of UlView). A razão de criarmos uma view customi- 
zada é que os eventos de toque precisam ser sobrescritos e, além disso, para desenhar 
os círculos é necessário também implementar manualmente o código de desenho. 

Como a intenção é desenhar todos os pontos de toque, e não apenas o 
último, precisamos guardar cada uma das interações. Para isso, usamos um 
NSMutableArray (já que o NSArray não pode ser modificado após ser criado), 
conforme o código abaixo, do arquivo CirculoView.h: 


// CirculoView.h 
# import <UIKit /UIKit.h> 


Qinterface CirculoView : UlView { 
NSMutableArray *circulos; 


} 
@end 


A diversão ocorre no arquivo CirculoView.m. A primeira parte do código 
consiste em registrar um log de quando o usuário toca na tela (unicamente por ques- 
tões de visualizar a ordem dos eventos), e registrar o ponto de toque quando o dedo 
for retirado da tela. Veja o código abaixo: 


// CirculoView.m - Código parcial 
- (void) touchesBegan: (NSSet *)touches withEvent: (UlEvent *)event { 
NSLog(0"Recebido touchesBegan"); 
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- (void) touchesEnded: (NSSet *)touches withEvent: (UlEvent *)event 1 
if (!circulos) { 
circulos = [[NSMutableArray alloc] init]; 


NSLog(@"Recebido touchesEnded. Registrando o ponto de toque"); 


UlTouch *toque = [touches any0bject]; 
CGPoint localizacaoToque = [toque locationInView:self]; 


// Precisamos encapsular o CGPoint dentro dentro de um NSValue 
// o CGPoint não é um objeto propriamente dito 
[circulos addObject: [NSValue valueWithCGPoint:localizacaoToque]] ; 


[self setNeedsDisplayl; 


Por conveniência iniciamos a propriedade circulos nas linhas 7 a 9, porém 
geralmente o mais comum é fazer isso em algum método init — mas não existe 
uma regra, e na prática acaba valendo muito mais a praticidade e tipo de código 
sendo feito. 

Na linha 13 pegamos o objeto de toque em si, representado pela classe ULTouch. 
Note que o pedaço correspondente a [touches anyObject] é um pouco estra- 
nho, mas para este contexto é seguro lê-lo como “retorne o ULTouch mais conveni- 
ente” Uma vez tendo obtido o objeto que representa o toque, precisamos saber em 
qual parte da tela o usuário colocou o dedo, para desenhar o círculo naquela posição. 
Isso é feito na linha 14 através do método locationInViewda UITouch, que re- 
cebe uma outra view como parâmetro (no caso, a nossa própria view) e retorna uma 
struct dotipo CGPoint com a posição convertida para o sistema de coordenadas 
da nossa view. 

A nossa lista circulos somente trabalha com objetos, eo CGPoint, por ser 
uma struct, acaba sendo incompatível. Para isso, na linha 18 adicionamos a po- 
sição obtida na lista circulos encapsulando a variável localizacaoToque em 
um NSValue, que pode ser considerado como um “objeto coringa” para carregar 
diversos tipos primitivos em lugares onde apenas objetos são aceitos. 

Por último, na linha 20, informamos ao iOS que é necessário redesenhar a view, 


para que o círculo seja mostrado na tela. Isso é feito no código abaixo: 
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ı -(void) drawRect: (CGRect)rect 1 


2 


CGContextRef contexto = UlGraphicsGetCurrentContext (); 
CGContextSetLineWidth(contexto, 2.0); 

CGColorRef corFundo = [UIColor redColor] .CGColor; 
CGContextSetFillColor(contexto, CGColorGetComponents (corFundo)); 


int tamanho = 25; 


for (NSValue *item in circulos) 1 
CGPoint ponto = [item CGPointValue] ; 
CGRect regiao = CGRectMake(ponto.x, ponto.y, tamanho, tamanho); 
CGContextAddEllipseInRect (contexto, regiao); 
CGContextFillEllipseInRect (contexto, regiao); 


CGContextStrokePath(contexto); 


O método drawRect é o responsável por realizar as tarefas de desenho na nossa 


view, e o iOS chama-o automaticamente quando necessário. Numa primeira olhada 
o código completo do método assusta, pois é bastante coisa para pouco resultado, 
utilizando a API procedural do Core Graphics para fazer os desenhos. A parte mais 
relevante concentra-se entre as linhas 8 e 13, onde iteramos por todos os pontos de 
toque registrados no método touchesEnded, desenhando os círculos na tela. 





Como alista circulos contém objetos do tipo NSValue, na linha 9 utilizamos 


o método CGPointValue para recuperar o CGPoint adicionado quando o usuário 
interagiu com o aplicativo, e na linha 10 definimos a área, enquanto que o código das 


linhas 11 e 12 pinta o círculo propriamente dito. 





A PROPRIEDADE USERINTERACTIONENABLED 


Toda Ulview contém uma propriedade chamada 
userInteractionEnablea, que quando definida para o valor 
YES, permite a interação do usuário com a view através de eventos 
de toque. Por padrão este valor é definido para YES, porém algumas 
classes, como a UlImageView, definem esta propriedade para NO, 











sendo então necessário habilitá-la manualmente. 











Para utilizar a “CirculoView” crie uma nova instância dela no método 


loadView no arquivo “ViewController.m”, conforme abaixo: 
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* import "Viewlontroller.h” 
t import "CirculoView.h"” 


Cimplementation ViewController 

- (void) loadView 1 
CirculoView *c = [[CirculoView alloc] init]; 
c.backgroundColor = [UIColor whiteColor] ; 
self.view = c; 


@end 


O resultado do aplicativo está demonstrado na figura 8.1. 


| iOS Simulator - iPhone Retina (3.5-inch) / iOS 7.0.3 (118508) 





Carrier = 2:29 AM sd 














Figura 8.1: Resultado do aplicativo que desenha círculos 
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8.2 UMA ABORDAGEM MAIS PRÁTICA: D DE GESTOS 


Da mesma forma que os eventos de toque permitem um elevado nível de customi- 
zação e controle sobre as interações do usuário com a tela, eles podem facilmente se 
tornar mais complicados de desenvolver e manter do que poderíamos desejar. Para 
auxiliar neste quesito, a Apple introduzir na API do iOS o conceito de reconhece- 
dores de gestos (do termo em inglês Gesture Recognizer), que são representados por 
um conjunto de classes para as operações mais comuns do dia a dia, além da pos- 
sibilidade de que os nossos próprios gestos sejam criados (sugestão: funcionalidade 
especial no seu aplicativo para quem desenhar um disco voador utilizando gestos). 


Os seis gestos padrão que vem com o iOS são os seguintes: 


e Toque (tap): classe UlTapGestureRecognizer 


e Pinça, para zoom (pinch in e pinch out): classe 


UlPinchGestureRecognizer 
e Arrastar (panning): UlPanGestureRecognizer 
e Deslizar (swipe): UILSwipeGestureRecognizer 
e Rotacionar: UIRotationGestureRecognizer 


* Toque longo (long press): UILongPressGestureRecognizer 


Como mencionamos no início do livro, a questão sobre traduzir ou não determi- 
nados termos em livros técnicos é sempre polêmica, e no caso dos reconhecedores de 
gestos (gesture recognizers) ainda existe o complicador que muitos dos termos origi- 
nais se referem às próprias classes e conceitos. Neste capítulo mostraremos sempre 
que possível o termo em português seguido do termo em inglês, por duas razões: 
a primeira delas é que os clientes e usuários leigos têm mais facilidade para enten- 
der instruções como “faça o movimento de pinça” do que “faça um pinch”, e isso 
ajuda muito em reuniões e outras conversas. O segundo motivo — mostrar também 
o termo em inglês — é para facilitar a identificação dos métodos e classes da API, 
assim como facilitar na busca por conteúdo na Internet. 

Existe uma diferença quase sutil entre os gestos de arrastar (panning) e deslizar o 
dedo (swipe) que pode não ficar muito clara no início: a primeira consiste em colocar 
o dedo na dela e arrastá-lo continuamente, para mover uma view de um lugar para 
outro, por exemplo. Já o deslizar é um movimento que se assemelha a arrastar, porém 
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ocorre mais rapidamente e de uma única vez, sendo muito utilizado para “folhear” 
jornais e revistas e passar de uma imagem para outra na galeria de fotos. 

Gestos são sempre associados a alguma view. Quando identificados, o sistema 
operacional envia mensagens à classe de eventos que foi especificada na criação do 
gesto. Além disso, são categorizados em dois tipos: contínuos, em que mensagens 
do evento são enviadas continuamente enquanto o usuário está com o dedo na tela 
— tais como o gesto de deslizar (panning) —, e descontínuos, que ocorrem apenas 
uma única vez — tais como toque (tap) ou deslizar (swipe). O evento de toque pode 
ser utilizado tanto para toque simples (single tap) como para duplo (double tap) ou 
mesmo mais: basta especificar a quantidade de toques desejadas na hora de criar a 
classe. 


8.3 CONVERTENDO O EXEMPLO CIRCULOVIEW PARA GES- 
TOS 


Crie um novo projeto chamado TapCirculos da mesma forma do projeto feito no 
início deste capítulo, porém adicione a classe TapCirculoView desta vez (ao invés 
da CirculoView que foi utilizada anteriormente). O arquivo TapCirculo View.h é 
igual: 


// TapCirculoView.h 
t import <UIKit /UIKit.h> 


QGinterface TapCirculoView : UlView { 
NSMutableArray *circulos; 


} 
@end 


A principal mudança será na classe TapCirculoView, onde precisamos regis- 
trar o evento de toque desejado, e lidar com a mensagem enviada pelo iOS quando 
o usuário interagir com o aplicativo. A primeira parte do código está abaixo: 


// TapCirculoView.m 
# import "TapCirculoView.h" 


@interface TapCirculoView() 


- (void) registraEventos; 
@end 
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s Cimplementation TapCirculoView 


10 =(1d) init { 


n if ((self = [super init])) { 
12 [self registraEventos] ; 
3 } 

15 return self; 

16 } 


O código das linhas 4 a 6 apenas declara a existência do método 





registraEventos somente para o compilador não emitir um alerta, con- 
forme vimos no capítulo sobre Objective-C. Já no método init (que é o construtor 
da classe), aproveitamos para registrar os eventos de toque, conforme abaixo: 


// TapCirculoView.m 


n 


2 -(void) registraEventos { 


3 UlTapGestureRecognizer *toque = [[UITapGestureRecognizer alloc] 
4 initWithTarget:self action:Qselector(toqueRecebido:)]; 

5 

6 toque.number0fTapsRequired = 1; // Valor padrão é 1 

7 [self addGestureRecognizer: toque] ; 

8 } 


Ao contrário do exemplo apresentado no início do capítulo, que sobrescrevia os 





métodos touchesBegan e touchesEnded da classe UIView, os reconhecedo- 
res de gesto são classes independentes, podendo inclusive ser criadas em qualquer 





outra classe. No nosso caso, isso é feito no método registraEventos. A classe 
UlTapGestureRecognizer contém a propriedade numberofTapsRequired, 
que serve para informar quantos toques o usuário deverá fazer para que a ação seja 
disparada, o que é feito na linha 6. Na linha 7 adicionamos o gesto na view, para que 
o iOS possa identificar as ações no momento em que for apropriado — ou seja, sem 
o código da linha 7, nada aconteceria. 

Todos reconhecedores de gestos seguem a mesma estrutura de construção, es- 
perando a classe que irá tratar os eventos ( initWithTarget) e o método naquela 
classe (action) que será responsável pela ação em si. Isso é feito nas linhas 3 e 4, 
onde passamos a própria view como delegate, e a “referência” ao método que deverá 
ser executado, cuja implementação está abaixo: 


1 // TapCirculoView.m 
2 - (void) toqueRecebido: (UlGestureRecognizer *) gesto { 
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if (!circulos) { 
circulos = [[NSMutableArray alloc] init]; 


CGPoint localizacaoToque = [gesto locationInView:self]; 
[circulos add0bject:[NSValue valueWithCGPoint:localizacaoToque]]; 
[self setNeedsDisplay] ; 


O valor do argumento action deve seguir um dos dois formatos abaixo: 


- (void) gestoRecebido; 
- (void) gestoRecebido:(UIGestureRecognizer *) gesto; 


A diferença entre ambos é que o segundo recebe como argumento o reconhece- 
dor de gesto (tap, swipe, panning etc.) que enviou a mensagem, o que pode ser útil 
tanto para utilizar o mesmo método para diversos eventos, ou — o caso mais corri- 
queiro — para obter algumas informações adicionais necessárias para a execução da 
lógica. 





O método toqueRecebido: é o correspondente ao touchesEnded do 
exemplo anterior, não havendo diferenças substanciais na lógica, tanto que o có- 
digo da linha 7 é virtualmente igual à outra implementação, porém utilizando um 
UIGestureRecognizer 

A classe TapCirculoView ainda precisa do método drawRect:, que você 
pode copiar integralmente do exemplo anterior. Lembre-se também de mudar o 
método loadView da classe ViewCont roller para o seguinte: 


- (void) loadView { 
TapCirculoView *c 


[[TapCirculoView alloc] init]; 
[UIColor whiteColor]; 


c.backgroundColor 
self.view = C; 


8.4 TREMEDEIRA COM TOQUE LONGO 


Os ícones do iOS são bastante medrosos, bastando segurá-los por algum tempo para 
que comecem a tremer desesperadamente. Para demonstrar o gesto de toque longo 
(long press) e o uso de mais de um gesto na mesma view, vamos fazer um aplicativo 
que também faz tremer as views, porém dando a opção de acabar com o sofrimento 
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delas realizando um duplo toque (double tap). Além disso, este exemplo mostrará 
recursos mais avançados de decoração das views. 

Crie um novo projeto chamado “TremeTreme” com as configurações padrão 
de sempre, e já adicione uma classe chamada TremeTremeView, que estende 
de UlView. Como o código é um pouco maior que de costume, iremos ver 
a implementação por partes. Todo o código a seguir é referente ao arquivo 
TremeTremeView.m, não há nenhum código no TremeTreme .h desta vez. 


é import "TremeTremeView.h" 
t import <QuartzCore/Quartzlore.h> 


tdefine RADIANS(degrees) ((degrees * MPT) / 180.0) 


Qinterface TremeTremeView () 
-(void) registraGestos; 

- (void) enfeitaView; 

Gend 


Cimplementation TremeTremeView 


- (Cid) initWithFrame: (CGRect)frame { 
if ((self = [super initWithFrame:frame])) { 
[self enfeitaView]; 
[self registraGestos]; 


return self; 


Entre as linhas 1 e 9 temos algumas declarações gerais para que o resto da classe 
possa funcionar corretamente, sendo que a parte nova é a linha 2, que importa o 
framework de animação Quartz, e a linha 4 que define uma constante RADIANS 
para converter graus para radianos. Além disso, note que na linha 13 estamos de- 
clarando o inicializador initWithFrame: ao invés de apenas init, pois é o mé- 
todo que será utilizado mais adiante no controlador para criar instâncias desta view 
já especificando seu tamanho. Muito importante: como estamos sobrescrevendo 
initWithFrame:, na linha 14 é necessário também executar 0 initWithFrame: 
de super, caso contrário o seu aplicativo se comportará de maneiras estranhas. 


Seguindo, temos o método enfeitaView: 
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-(void) enfeitaView { 
self.layer.masksToBounds = NO; 
self.layer.cornerRadius = 8; 
self.layer.shadowlffset = CGSizeMake(-2, 2); 
self.layer.shadowRadius = 5; 


ll 


self.layer.shadowlpacity = 0.5; 


O código deste método depende daquele import do QuartzCore feito anteri- 
ormente, para que possamos acessar a propriedade layer. Na linha 3 dizemos que 
as bordas da view devem ser arredondadas em 8 pixels. Na linha 4 é adicionado uma 
pequena sombra com o tamanho do código existente na linha 5, enquanto que a li- 
nha 6 especifica em 50% a opacidade da sombra. Com estas opções o aspecto visual 
ficará muito mais agradável para o usuário (experimente remover este método, para 
ver a diferença causada). 

Os gestos são criados no método registraGestos: 


- (void) registraGestos { 
UlLongPressGestureRecognizer *toqueLongo = 
[[UILongPressGestureRecognizer alloc] initWithTarget:self 
action: Oselector(iniciaTremedeira:)]; 
toqueLongo .minimumPressDuration = 0.8; 
[self addGestureRecognizer:toqueLongo] ; 


UlTapGestureRecognizer *toqueParar = 
[[UITapGestureRecognizer alloc] inithlithTarget:self 
action:Qselector (pararAnimacao)]; 
toqueParar .number0fTapsRequired = 2; 
[self addGestureRecognizer:toqueParar]; 


A principal novidade é a classe UlLLongPressGestureRecognizer, utilizada 
para gestos quando o usuário toca a tela e mantém o dedo pressionado por um 
determinado tempo até disparar o evento de iniciar a tremedeira da view, que no 
nosso caso são 300 milissegundos, conforme feito na linha 4. Além disso, preci- 
samos de uma maneira de fazer a view parar de tremer, e para tanto é utilizado o 
UlTapGestureRecognizer com 2 toques. Resumindo: toque e segure o dedo em 
cima da view por pelo menos 300 milissegundos para fazê-la começar a tremer, e 
depois toque 2 vezes rapidamente para parar. 


O código que inicia a tremedeira está abaixo: 
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- (void) iniciaTremedeira: (UlGestureRecognizer *) gesto 1 
CGAffineTransform oscilaEsquerda = CGAffineTransformRotate( 
CGAffineTransformidentity, RADIANS(-5.0)); 


CGAffineTransform oscilaDireita = CGAffineTransformRotate( 
CGAffineTransformIdentity, RADIANS(5.0)); 


self.transform = oscilaEsquerda; 


UlViewAnimationÚptions opcoes = UlViewAnimationOptionRepeat 
| UlViewAnimationOptionAllowUserInteraction 
| UlViewAnimationOptionAutoreverse 
| UIlViewAnimationCurveEaseInOut ; 


[UIView animateWithDuration:0.1 delay:0 options:opcoes animations 
self .transform = oscilaDireita; 
} completion:nil]; 


A lógica é a seguinte: queremos fazer a view girar rapidamente 5 graus para a 
esquerda e 5 graus para a direita, o que é conseguido com o uso de transformações do 
Core Animation. Naslinhas 2 e 3 definimos a oscilação para a esquerda, enquanto 
nas linhas 5 e 6, a oscilação para a direita, e as aplicamos na propriedade transform 
da própria view, conforme as linhas 8 e 16. Entre as linhas 15 e 17 criamos e ini- 
ciamos a animação, da seguinte maneira: cada oscilação deverá durar 100 milisse- 
gundos ( animateWithDuration:0.1), sendo que deve começar imediatamente 
( delay:0). Para que tudo funcione corretamente, passamos uma série de opções 





do tipo UlViewAnimationOptions que são determinadas entre as linhas 10 e 
13. UlViewAnimationOptionRepeat informa que o bloco de animação deve se 





repetir indefinidamente, UlViewAnimationOptionAllowUserInteraction 





é necessário para que o duplo toque de parar seja identificado, pois caso contrá- 
rio o iOS irá ignorar interações com a view enquanto ela estiver sendo animada. 
UlViewAnimationOptionAutoreverse especifica que, ao chegar no final, a ani- 





mação deve automaticamente voltar para o ponto inicial (que é o da linha 8), en- 





quanto que a opção UlViewAnimat ionCurveEaseInOut é um ajuste fino na ma- 
neira como a animação ocorre. 


Para parar a tremedeira, implemente o seguinte método: 


1 -(void) pararAnimacao { 


2 


UlViewAnimationÚptions opcoes = 
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3 UlViewAnimationOptionBeginFromCurrentState; 

4 

5 [UIView animateWithDuration:0 delay:0 options:opcoes animations:^{ 
6 self .transform = CGAffineTransformidentity; 

7 kcompletion:nil]; 

s } 


A lógica deste código pode não ser muito clara a princípio, porém funci- 
ona assim: cada UIView independente somente pode ter um bloco de ani- 
mação sendo executado por vez, e não existe um método “parar animação”. 
Portanto, o que fazemos é disparar outra animação que dura zero segundos ( 
animateWithDuration:0), que retorna a view para o estado normal, conforme 
a linha 5. O código da linha 2 é importante para que a transição seja feita a partir 
do estado em que a view se encontra no momento — em outras palavras, para ficar 
mais suave. 

A última parte do código consiste na classe ViewController.m, conforme 


abaixo: 


ı #import "ViewController.h" 
2 #import "TremeTremeView.h" 
3 


4 @implementation ViewController 


5 
6 - (void) criaTremeTremeView: (CGPoint) posicao comCor:(UIColor *) cor { 


7 CGRect r = CGRectMake(posicao.x, posicao.y, 60, 60); 

8 TremeTremeView *t = [[TremeTremeView alloc] initWithFrame:r]; 
9 t.backgroundColor = cor; 

10 [self.view addSubview:t]; 

11 } 


3 - (void)viewDidLoad { 


14 [super viewDidLoad] ; 

15 self.view.backgroundColor = [UIColor whiteColor]; 

16 

17 [self criaTremeTremeView:CGPointMake (50, 50) 

18 comCor: [ULColor blueColor]]; 
19 [self criaTremeTremeView:CGPointMake (200, 150) 

20 comCor: [UIColor greenColor]]; 
a [self criaTremeTremeView:CGPointMake(110,250) 

22 comCor: [UIColor purpleColor]]; 
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3 + 
24 Gend 


O método CriaTremeTremeView:comCor: das linhas 6 a 11 é utilizado nas 
linhas 17, 19 e 21, sendo responsável por criar instâncias da TremeTremeView em 
um lugar centralizado — afinal, duplicar código nunca é bom, certo?! 


O resultado deste aplicativo está na figura 8.2. 


iOS Simulator - iPhone Retina (3.5-inch) / iOS 7.0.3 (118508) 
| Carrier = 2:50 AM ld 











Figura 8.2: Views tremendo de medo. Repare nas habilidades visuais do autor 


8.5 DESLIZANDO UMA VIEW COM O GESTO SWIPE 


O próximo exemplo demonstra o uso do gesto swipe, que é um movimento que se 
assemelha a jogar (ao invés de arrastar) algo de uma direção para outra com o dedo, 
como navegar pelas imagens de uma galeria de fotos. O programa consistem em um 
retângulo que pode ser jogado de um lado para o outro. Crie um novo projeto cha- 
mado “GestoSwipe” e declare uma variável do tipo ULView chamada “quadrado” no 
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arquivo ViewController.h, conforme exemplificado abaixo. Este será o objeto 
que manipularemos com o gesto. 


// Viewlontroller. 
# import <UIKit /UlKit.h> 


Qinterface ViewController : UlViewController ( 
UlView *quadrado; 


Gend 


Feito isso, precisamos implementar a lógica em si, no arquivo 
ViewController.m. Como os gestos devem necessariamente estar funcio- 
nando quando o aplicativo estiver pronto para o uso, precisamos registrá-los de 
maneira automática quando a tela for carregada, para que não haja a possibilidade 
de esquecermos de fazer isso manualmente em algum outro momento. O método 
viewDidLoad da classe ULViewCont roller pode ser sobrescrito para fazer este 
trabalho, pois é executado automaticamente uma única vez, durante a inicialização 
do controlador. Veja o código abaixo. 


// ViewController.m 

- (void)viewDidLoad { 
[super viewDidLoad] ; 
[self criaQuadrado] ; 
[self registraGestos]; 


A primeira coisa a fazer é criar a view que será manipulada em cada gesto, re- 
presentada pela variável quadrado: 


- (void) criaQuadrado { 
quadrado = [[UIView alloc] 
initWithFrame:CGRectMake(100, 100, 100, 100)]; 
quadrado .backgroundColor = [UIColor yellowColor]; 
[self .view addSubview: quadrado] ; 


Já o método registraGestos, responsável por adicionar os swipes, segue 
abaixo: 
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- (void) registraGestos { 
[self adicionaGesto:UISwipeGestureRecognizerDirectionRight]; 
[self adicionaGesto:UISwipeGestureRecognizerDirectionLeft]; 


- (void) adicionaGesto: (UISwipeGestureRecognizerDirection) direcao { 
UISwipeGestureRecognizer *swipe = [[UISwipeGestureRecognizer alloc] 
initWithTarget:self action:Qselector (jogaQuadrado:)]; 
swipe.direction = direcao; 
[self.view addGestureRecognizer:swipe]; 


É no método adicionaGesto: queo trabalho de adicionar os gestos é feito de 
fato. Note que precisamos fazer isso para cada direção desejada, que é especificada 
na propriedade direction, na linha 9. Já o método que lida com o swipe precisa 
primeiro verificar se o usuário fez o movimento dentro da área do retângulo, e então 
deslocar o mesmo para a esquerda ou para a direita: 


- (void) jogaQuadrado: (UlGestureRecognizer *) gesto { 
CGPoint location = [gesto locationInView:quadrado] ; 


if ([quadrado pointInside:location withEvent:nil]) 1 
UlSwipeGestureRecognizer *swipe = 
(UISwipeGestureRecognizer *)gesto; 


float novoX = swipe.direction == 
UlSwipeGestureRecognizerDirectionLeft ? O 
(self.view.frame.size.width - quadrado.frame.size.width); 


[UIView animateWithDuration:0.3 delay:0 
options:UlViewAnimation0ptionCurveEaseIn0ut 
animations:” { 
CGRect frame = quadrado.frame; 
frame.origin.x = novokX; 
quadrado. frame = frame; 

} completion:nil]; 


Na linha 4 verificamos se o toque ocorreu na área do quadrado propriamente 
dito, e caso isso seja verdade, definimos a nova posição horizontal do quadrado de 
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acordo com a direção do swipe, nas linhas 7 a 9. O restante do método simplesmente 
anima a troca de posição para a posição do novoxX. 

Rode o application com Command + Re faça os movimentos do gesto (se 
for com o mouse, clique e arraste para simular o mesmo efeito do dedo). A view 
quadrado deverá deslizar para a direção determinada. 
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CAPÍTULO 9 


Trabalhe com mapas e GPS na sua 
aplicação 


Este é sem dúvida um recurso que aparece em muitas aplicações, às vezes em con- 
textos totalmente diferentes do que esperamos. A API não é complicada e você verá 
que com o conhecimento que obteve até aqui é fácil atacar uma nova biblioteca. Até 
a versão 5 do iOS o sistema de mapas utilizado é o do Google, enquanto que a partir 
do iOS 6 os mapas são da Apple. 

O código-fonte deste capítulo está disponível na pasta “MinhaLocalizacao” (lem- 
brando que o endereço do site com os códigos está na introdução do livro). 


9.1 ÁS BIBLIOTECAS NECESSÁRIAS 


Crie um novo projeto com o sugestivo nome de MinhaLocalizacao, utilizando 
as mesmas configurações padrão dos outros projetos feitos até agora no livro. 


A primeira coisa a fazer é adicionar as bibliotecas necessárias para trabalhar com 
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mapas, chamada de MapKit, e a de localização, chamada CoreLocation. Abra as 
propriedades do projeto, selecione a aba Build Phases, e expanda a seção Link Binary 
with Libraries, conforme mostra a figura 9.1. Clique no botão + e adicione o item 


MapKit.framework e CoreLocation. framework. 


eoo ES MinhaLocalizacao.xcodeproj a 
D E | A) [$ iPhone Ret.. | MinhaLocalizacao: Ready | Today at 2:59 AM No Issu EHA DG 





na asa O =» AB |m] < r EMinhatocalizacao 


ne E E] A Minh..izacao$ General Capabilities Info Build 5; Build Phases Build Rul 
Y [] Minhatocalizacao 


[Ñ] AppDelegate.h 
[m] AppDelegate.m 
(E Main.storyboard 
[h] ViewController.h 
[m] ViewController.m ee pança Bda 
E Images xcassers Link Binary With Libraries (5 items) o 
> C Supporting Files 
> [] MinhaLocalizacaoTests 





> Target Dependencies (0 items) 


> Compile Sources (3 items) o 


[83 CoreLocation.framework Required $ 
b C Frameworks - ired ê 
É Mapkit.framework Required $ 

> C Products 
EB3 CoreGraphics.framework Required $ 
E Ulkit.framework Required $ 


É Foundation.fra: Required $ 
+ 








Figura 9.1: Adicionando as bibliotecas MapKit e CoreLocation 


9.2 ADICIONANDO O MAPA À APLICAÇÃO 


Adicionar mapas aos nossos aplicativos é uma tarefa surpreendentemente simples, 
pois o SDK do iOS já vem com um componente pronto com virtualmente tudo o que 
é necessário para ter o mapa funcionando. Não é necessário nos preocuparmos com 
questões de rede, posicionamento de imagens, performance e afins, o que nos deixa 
livre para concentrar esforço na lógica de negócios principal. 

Abra o arquivo Main.storyboard e adicione o componente Map View, loca- 
lizado na Object Library (CTRL + Option + Command + 3, ou pelo menu View 
-> Utilities -> Show Object Library), posicionando-o de tal forma que ocupe toda a 
área visível do aplicativo. Além disso vamos precisar manipular o mapa diretamente 
pelo código, portanto é necessário criar um Outlet para ele: abra o Assistant Editor 
(Option + Command + ENTER), selecione o mapa, segure o CTRL e arraste para 











o arquivo ViewController.h, dando o sugestivo nome “mapa”. 
Se você tentar compilar o aplicativo verá que o Xcode reclama que não sabe 
o que significa o tipo MkMapView - isso deve-se ao fato que ele está localizado 
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em um arquivo de cabeçalho específico, MapKit/MapKit.h. Altere o arquivo 
ViewController.h conforme o código abaixo. Repare que na linha 2 importa- 
mos o cabeçalho correto do MapKit. 


# import <UIKit /UIKit.h> 
# import <MapKit /MapKit.h> 


Ginterface ViewController : UlViewController 
Oproperty (retain, nonatomic) IBQutlet MKMapView *mapa; 


@end 


Rode o aplicativo e interaja com o mapa: arraste-o, dê duplo clique para realizar 
zoom, e veja que tudo funciona muito bem! 


9.3 SIMULANDO MÚLTIPLOS TOQUES 


Diversos aplicativos fazem uso de múltiplos toques para realizar certas ações. No 
caso de mapas, toque duplo com um único dedo (duplo clique do mouse no simu- 
lador) aumenta o zoom, enquanto que um toque simples com dois dedos diminui o 
zoom. Para simular toque com dois dedos basta segurar a tecla Option e fazer o 
movimento de pinch in e pinch out com o mouse. A figura 9.2 mostra o aplicativo 
rodando e o indicador visual de toques múltiplos. 
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Figura 9.2: Indicador visual de toques múltiplos 


9.4 POSICIONANDO O MAPA AUTOMATICAMENTE NA LOCA- 
LIZAÇÃO DO USUÁRIO 


Para mostrar a localização atual do usuário, precisamos apenas definir a propriedade 





showsUserLocation para YES: 


- (void)viewDidLoad { 
[super viewDidLoad] ; 
self .mapa.showsUserLocation = YES; 


Rode o aplicativo novamente e ele deverá mostrar uma mensagem solicitando 
permissão para acessar a sua localização atual, conforme a figura 9.3. Clique em 
“OK” para permitir. 
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“MinhaLocalizacao” Would 
Like to Use Your Current 
Location 


Don't Allow 





Figura 9.3: Aplicativo solicitando acesso à localização do usuário 


Para facilitar os testes, o iOS Simulator permite a inserção manual de qualquer 
latitude e longitude, conforme mostra a figura 9.4. Basta acessar o menu Debug -> 
Location -> Custom Location... 


Enter a latitude and longitude for the location you 
would like to simulate. 


Latitude: 


Longitude: -122.406417 





Figura 9.4: Inserindo manualmente uma determinada latitude e longitude 
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9.5 TRABALHE COM O ZOOM 


Embora o aplicativo mostre a nossa posição, a visão do mapa está sendo vista muito 
de cima, e o que queremos é apresentar ao usuário quase ao nível da rua. Para definir 
o nível de zoom é necessário especificar o tamanho desejado da área visível, o qual é 
representado em um sistema de coordenadas próprio do MapKit. Existem diversas 
maneiras e momentos em que é possível realizar esta ação, e a que apresentaremos 
como exemplo consiste em modificar o zoom no momento em que o mapa recebe 
aquele pininho azul que aponta a localização do usuário. 

O componente Map View tem diversos eventos os quais podemos es- 
cutar, e um deles diz respeito ao momento em que algum pino é adicio- 
nado ao mapa — o mapView:didAddAnnotationViews:, definido no 
delegate ' MKMapViewDelegate, sendo necessário importá-lo no arquivo 
ViewController.h conforme o código abaixo: 


Qinterface ViewController : UlViewController<MkMapViewDelegate> 
Oproperty (weak, nonatomic) IBQutlet MKMapView *mapa; 
@end 


Falta informar ao mapa onde estarão implementados os métodos do delegate, 


no caso, a própria ViewController.m: 


- (void)viewDidLoad { 
[super viewDidLoad] ; 
self .mapa.showsUserLocation = YES; 


// Define a própria classe ViewController como tendo os métodos 
// do delegate do MapkKit 
self .mapa.delegate = self; 


E a implementação do método mapView:didAddAnnotationViews: 


- (void) mapView: (MKMapView *)mapView 
didAddAnnotationViews: (NSArray *)views { 
MKAnnotationView *v = [views objectAtIndex:0]; 
CLLocationDistance distancia = 400; 
MKCoordinateRegion regiao = MKCoordinateRegionMakeWithDistance( 
[v.annotation coordinate], distancia, distancia); 
[self .mapa setRegion:regiao animated:YES]; 
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As linhas 4 e 5 definem a região do zoom com base na distância em metros de- 
finida na linha 3. Rode-o novamente, e o resultado deverá ser algo como a figura 


9.5. 
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Figura 9.5: Mapa com zoom aplicado 


9.6 ADICIONANDO PINOS AO MAPA 


Para finalizar o aplicativo de mapas, vamos permitir que o usuário insira pinos em 
qualquer lugar ao realizar um toque longo de pelo menos 500 milissegundos, e cen- 
tralizar o mapa na região deste pino. A primeira coisa a fazer é adicionar ao mapa 
um gesto do tipo ULLongPressGestureRecognizer, conforme o código abaixo: 


- (void)viewDidLoad { 
[super viewDidLoad]; 
self .mapa.showsUserLocation = YES; 
self .mapa.delegate = self; 
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// Adiciona ao mapa o gesto de toque longo 
UlLongPressGestureRecognizer *toqueLongoMapa = 
[[UILongPressGestureRecognizer alloc] initWithTarget:self 
action:Qselector (adicionaPino:)]; 


toqueLongoMapa.minimumPressDuration = 0.5; 
[self .mapa addGestureRecognizer:toqueLongoMapa] ; 


A implementação do método adicionaPino: segue abaixo: 


- (void) adicionaPino: (UIGestureRecognizer *) gesto 1 
if (gesto.state == UlGestureRecognizerStateBegan) { 
CGPoint ponto = [gesto locationInView:self.view]; 


CLLocationCoordinate2D coordenadas = 
[self .mapa convertPoint:ponto toCoordinateFromView:self.mapa]; 


MKPointAnnotation *pino = [[MKPointAnnotation alloc] init]; 
pino.coordinate = coordenadas; 
[self .mapa addAnnotation:pino]; 


A verificação na linha 2 é necessária para que o pino seja adicionado apenas 
uma única vez, dado que o gesto de toque longo dispara o evento quando o dedo é 
retirado da tela também. Nas linhas 5 e 6 convertemos a posição do toque na tela 
para o sistema de coordenadas do mapa. O resto do método simplesmente cria o 
pino e adiciona-o ao mapa. 

Ao realizar um toque longo, o método mapView: didAaddAnnotationViews: 
implementado anteriormente será automaticamente executado pelo iOS, centrali- 
zando o pino na tela, conforme mostra a figura 9.6. 
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Figura 9.6: Resultado do aplicativo após a adição de diversos pinos 


9.7 DETECTE TOQUES NOS PINOS 


O delegate MKkMapViewDelegate tem diversos métodos interessantes, como o 
mapView:didSelectAnnotationView:, que é executado toda vez que o usuário 
interage com algum pino. Veja um exemplo no código abaixo, onde apenas mostra- 
mos uma mensagem de log quando isso ocorre — um uso mais criativo fica como 


lição de casa para você! 


- (void)mapView: (MKMapView *)mapView 
didSelectAnnotationView: (MKAnnotationView *) pino { 
NSLog(0"Pino %0 selecionado", pino); 
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Componentes gráficos customizados 


Com raras exceções, todos os componentes gráficos no iOS — botões, seletores de 
datas e valores, campos de texto, imagens, barras de navegação e tantos outros — 
descendem da classe UIView, que é também a classe que devemos estender para 
criar nossos próprios componentes visuais customizados. Na prática ela é relati- 
vamente simples, definindo uma área retangular na tela e as interfaces para geren- 
ciar conteúdo naquela área, tais como desenho e animação, eventos, layout e outras 
views-filhas. 

Neste capítulo veremos as principais propriedades e estrutura da UlView, de tal 
forma que seja possível aplicar o conhecimento na construção de aplicativos ricos e 
interativos, assim como criar seus próprios componentes. Ao contrário do resto do 
livro, aqui o conteúdo é apresentado num estilo mais próximo de guia de referência, 
inclusive por sua simplicidade. 

Views podem ser criadas totalmente na mão, com código puro, ou com um mix 
de código e layout visual, feito em conjunto com arquivos .xib através do Inter- 
face Builder. O resultado prático é idêntico, sendo que arquivos XIB são úteis para 
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elementos estáticos - caso queira manipular o que aparece e quando aparece, será 
necessário fazer via código a parte dinâmica. 
Geralmente a melhor alternativa é criar a tela em arquivos XIB, e fazer via código 


o que for dinâmico e / ou condicional. 


Desenho e animação 


- O conteúdo é desenhado utilizando tecnologias como UlIKit, Core 
Graphics e OpenGL ES. - Certas propriedades da view podem ser modificadas 





utilizando efeitos de animação. Veremos como fazer isso neste capítulo. 


Gerenciamento de layout e views-filhas 


- Uma UIView pode opcionalmente conter diversas outras views-filhas, chama- 
das de subviews. - Cada view pode definir as regras de redimensionamento em 
relação à view-pai. - Uma view-pai pode modificar o tamanho das views-filhas. 


Gerenciamento de eventos 


- Toda view pode lidar com eventos de toque e outros tipos de interação feitos 
pelo usuário. 


10.1 (CRIANDO VIEWS 


Por ser retangular, para criar views é necessário especificar as coordenadas x e y, além 
da largura e altura, conforme o exemplo abaixo: 


ı CGRect retangulo = CGRectMake(20, 20, 200, 200); 
2 UIView quadradoView = [[UIView alloc] initWithFrame:retangulo]; 


A API de UIView utiliza o nome frame (quadro, moldura) para se referenciar 
às coordenadas e dimensões da view. Você trabalhará bastante com esta propriedade. 
Para modificar o frame é necessário passar um CGRect completo novamente, como 


no exemplo abaixo: 


retangulo.frame = CGRectMake(50, 100, 150, 300); 


Tecnicamente o frame é representado por uma struct chamada CGRect, que 
por sua vez contêm outras duas structs chamadas size (que é do tipo cGSize) 
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e origin (dotipo CGPoint), que correspondes ao tamanho e posição respectiva- 
mente. Isso significa que para pegar o tamanho ou posição de qualquer view, basta 
fazer como no exemplo abaixo: 


float x = retangulo.frame.origin.x; 
float y = retangulo.frame.origin.y; 
float largura = retangulo.frame.size.width; 
float altura = retangulo.frame.size.height; 


Por outro lado, para modificar apenas algumas uma das propriedades ( x, y, 
widthou height) é necessário um pouco mais de trabalho, pois é preciso primeiro 
atribuir o frame% a uma variável temporária, modificá-la e atribuir de volta ao 


frame. Veja o exemplo abaixo: 


CGRect frame = retangulo.frame; 
frame.origin.x = 350; 
retangulo.frame = frame; 


Escrever apenas retangulo. frame.origin.x = 350 não funcionaria, pois 
como estamos lidando com structs em C, e frame é um valor (não um ponteiro) de 
UlView, tentar alterá-lo dessa forma não surtiria efeito (alteraria a cópia do frame 
em memória), e o compilador não permitiria. É um código bastante repetitivo, e no 
capítulo sobre Objective-C avançado veremos uma forma de tornar essa tarefa mais 
simples. 


10.2 ANIMANDO VIEWS 


Além de darem um aspecto mais bonito para a sua aplicação, animações são manei- 
ras muito úteis de informar ao usuário que alguma coisa está acontecendo. A pró- 
pria Apple recomenda que o uso deste recurso seja sempre considerado. Diversas 
propriedades da UIView têm suporte à animação de maneira extremamente fácil, 
bastando apenas informar que desejamos realizá-la, e modificar a propriedade em 
si. As seguintes propriedades podem ser animadas desta forma: 


e frame: para animar tamanho e posição 
e bounds: tamanho e posição 


e center: animar a posição 
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e transform: para rotacionar ou fazer scale 
* alpha: para animar a mudança de opacidade 


e contentStretch: para modicar a maneira como a view se estica 


Um lugar onde animações são bastante úteis é em transição de telas ou 
propriedades — sem contar, é claro, os aspectos puramente estéticos. Existem 
duas maneiras de animar estas propriedades: uma procedural, utilizando a dupla 
beginAnimatione commitAnimation, e outra mais “OO” com o uso de blocos. 
O resultado é exatamente o mesmo independentemente da técnica, contudo a partir 
do iOS 4 a maneira mais utilizada é a com blocos. 


10.3 ANIMANDO DA FORMA PROCEDURAL E TRADICIONAL 


A maneira mais tradicional de animar propriedades dos componentes é bastante pro- 
cedural e simples de entender e escrever. A técnica consiste em marcar o início da- 
quilo que desejamos animar, e depois aplicar a animação propriamente dita. 


O código abaixo demonstra isso: 


[UIView beginAnimations:nil context:nil]; 
[UIView setAnimationDuration:2]; 


CGRectMake(20, 308, 280, 132); 
0.3; 


minhaView.frame 


minhaView.alpha 


[UIView commitAnimations] ; 


Na linha 1 preparamos o ambiente, indicando que o código que vem abaixo de- 
verá ser executado em um bloco de animação, enquanto que o na linha 7 informamos 
o fim desta instrução — tudo o que vem no meio será animado. O código na linha 2 
especifica a duração da animação, sendo que o valor padrão é em torno de 300 mi- 
lissegundos. Já nas linhas 4 e 5 é feito o código que será animado de fato. O código 





completo está no projeto de exemplo AnimacaoTradicionalEx1. 


10.4 ANIMANDO COM O USO DE BLOCOS 


Blocos é um conceito que apareceu no iOS 4 e que torna muito mais simples (do 
ponto de vista de exigir menos código) a execução de diversas tarefas, incluindo a de 
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animação de views. Para realizar a mesma operação do exemplo anterior utilizando 
blocos, o código ficaria conforme exemplificado abaixo: 


[UIView animateWithDuration:2 animations:” { 
minhaView.frame = CGRectMake(20, 308, 280, 132); 
minhaView.alpha = 0.8; 

NH; 


Apesar da sintaxe um tanto estranha, o código fica muito mais enxuto. 


10.5 CRIANDO VIEWS CUSTOMIZADAS 


Views customizadas são muito úteis quando há a necessidade de reutilizar código 
de componentes visuais — por exemplo, seu próprio botão, componente de imagem 
que já apresenta uma descrição da foto, menu com suporte a eventos, desenho e 
virtualmente qualquer coisa que você possa imaginar. Além disso, é bem simples 
fazer isso: basta estender a classe ULView. Para melhor exemplificar, vamos criar um 
componente para realizar um hipotético login na aplicação, com campo de usuário, 
senha e o botão para validar os dados, conforme mostrado na imagem 10.1. O código 
do aplicativo de exemplo focará na parte de criar a tela customizada, deixando de 
lado qualquer lógica específica de autenticação propriamente dita. 
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Usuário 


Senha 








Figura 10.1: Componente de login adicionado no aplicativo 


Crie um novo projeto do tipo Single View Application e em seguida adicione 
uma nova classe chamada “LoginView” (Command + N), selecionando UIView no 
campo “Subclass of”. A tela de login poderá ser posicionada em qualquer lugar, po- 
rém a altura e largura deverão ser sempre as mesmas. 


Coloque tudo em LoginView.m 
Todos os fragmentos de código a seguir deverão ser adicionados no arquivo 
LoginView.m. 


Fragmentos para simplicidade e foco 


Criar e configurar componentes visuais no iOS é uma tarefa bastante monótona 
e repetitiva, frequentemente acompanhada de dezenas de linhas de código cuja única 
função é definir propriedades de cada um dos componentes. Para manter a objetivi- 
dade, aqui no livro iremos colocar apenas os pedaços principais, de tal forma que seja 
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possível demonstrar o que faremos porém sem poluir demais as páginas. O código 
completo você pode baixar no endereço http://bit.ly/ios- ViewCustomizada. 


O que devemos fazer 


Usando a imagem 10.1 como referência, o componente LoginView precisa ter 
o fundo com sombra que conterá toda a estrutura, uma caixa com cantos arredon- 
dados onde, dentro dela, existem dois componentes de texto para o nome de usuário 
e senha, e dois componentes para o usuário informar os respectivos valores. Por 
último, há um botão azul. Todos eles precisam ser instanciados e configurados ma- 
nualmente, incluindo as dimensões e localização. 

Para começar vamos sobrescrever o método init para que, ao ser instanciado, 
o componente já se autoconfigure, evitando assim que o desenvolvedor tenha que se 
lembrar de fazer ajustes manualmente toda vez. Confira o seguinte código: 


- (id) init { 
if ((self = [super init])) { 
[self constroiTela]; 


return self; 


Esta parte é bastante simples, e basicamente delega a tarefa de criar os compo- 
nentes ao método constroiTela, cuja primeira parte está abaixo: 


- (void) constroiTela { 
self.frame = CGRectMake(0O, O, 300, 150); 
self .backgroundColor = [UlColor colorWithRed:210.0/255.0 
green:210.0/255.0 blue:210.0/255.0 alpha:1]; 


// Restante do método 


Na linha 2 definimos o frame do componente, para que comece na posição o 
e que tenha 300 pixels de largura e 150 de altura. Nas linhas 3 e 4 definimos a cor 
de fundo para cinza claro, porém a sintaxe é peculiar: ao invés da classe UIColor 
permitir que uma cor seja criada apenas com os valores RGB (210 para os três neste 
caso), é necessário passar o código da cor na faixa de 0.0 (preto) a 1.0 (branco), razão 
pela qual o código RGB é divido por 255 — maluquices da Apple. 
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O restante do método constroiTela consiste em criar cada um dos com- 
ponentes restantes manualmente, definindo o frame de cada, opções específicas 
(como cor do texto ou tipo de fonte) e assim por diante — não há qualquer regra de 
negócios. Por este motivo, o código abaixo contêm apenas alguns fragmentos para 
servirem de guia para você, enquanto que o código completo pode ser baixado no 
endereço http://bit.ly/ios- ViewCustomizada. 


// Borda 
UlView *xborda = [[UIView alloc] 
initWithFrame:CGRectMake(10, 10, 280, 95)]; 
// Detalhes omitidos no livro 
[self addSubview:borda] ; 


// Labels 

UlLabel *usuarioLabel = [[UILabel alloc] 
initWithFrame:CGRectMake(10, 15, 100, 20)]; 

usuarioLabel.text = 0O"Usuário"; 

[borda addSubview:usuarioLabel]; 


UlLabel *senhaLabel = [[UILabel alloc] 
initWithFrame:CGRectMake(10, 60, 100, 20)]; 

// Detalhes omitidos no livro 

[borda addSubview: senhaLabel] ; 


// Campos texto 

UlTextField *usuarioField = [[UITextField alloc] 
initWithFrame:CGRectMake(110, 15, 150, 20)]; 

// Detalhes omitidos 

[borda addSubview:usuarioField]; 


UlTextField *senhaField = [[UITextField alloc] 
initWithFrame:CGRectMake(110, 60, 150, 20)]; 

// Detalhes omitidos 

[borda addSubview:senhaField]; 


// Linha horizontal divisória entre os campos 
UlView *linhaFina = [[UIView alloc] 
initWithFrame:CGRectMake(20, 50, 240, 1)]; 
linhaFina.backgroundColor = [UIColor greyColor]; 
[borda addSubview:linhaFinal; 
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// Botao 

UIButton *botaoLogin = [[UIButton alloc] 
initWithFrame:CGRectMake(O, 113, 180, 30)]; 

// Detalhes omitidos 

[botaoLogin setTitle:0"Login" forState:UIControlStateNormal] ; 

[self addSubview:botaoLogin]; 


Este código está resumido apenas para que você possa ter uma ideia do trabalho 
envolvido na adição manual de componentes à tela. 


10.6 UTILIZAR A VIEW CUSTOMIZA LOGINVIEW 


Uma vez que a view tenha sido criada, basta instanciá-la como qualquer outra 
classe, e adicionar como subview em algum lugar - em um controller. por exem- 
plo. No caso da app de demonstração “ViewCustomizada” isso é feito no método “ 
viewDidLoad” da classe ViewCont roller .m, conforme o seguinte código: 


- (void)viewDidLoad 
{ 


[super viewDidLoad]; 


LoginView *lv = [[LoginView alloc] init]; 
CGRect lvFrame = lv.frame; 
lvFrame.origin = CGPointMake( 
(self.view.frame.size.width - lvFrame.size.width) / 2, 30); 


lv.frame = lvFrame; 


[self.view addSubview:lv]; 


Na linha 5 o componente de login que criamos é instanciado sem qualquer dife- 
rença a tudo o que já vimos no livro, enquanto que entre as linhas 6 a 9 posicionamos 
em um lugar específico da tela - no caso, y 30 e centralizado no eixo horizontal. Por 
último, a linha 11 faz a “mágica” de adicionar o componente à tela. 


10.7 CONSTRUIR O COMPONENTE LOGINVIEW UTILIZANDO 
UM ARQUIVO XIB DE INTERFACE 


Fazer na mão dá uma trabalheira, não?! Portanto, outra alternativa é utilizar um 
arquivo XIB para criar o que for possível visualmente, através do Interface Builder, 


181 


10.7. Construir o componente LoginView utilizando um arquivo XIB de interface Casa do Código 





e fazer via código apenas coisas muito específicas ou dinâmicas. 

Crie uma nova classe chamada “LoginViewVisuaP ( CMD + N -> 
Objective-C Class) que herde de “UIView” (selecione no campo “Sub- 
class of”), e em seguida adicione um novo arquivo ( CMD + N novamente) do 
tipo “View”, localizado na seção “User Interface”, conforme mostra a imagem 10.2. 





Chame o arquivo de “ LoginViewVisual.xib” conforme a imagem 10.3. 


Choose a template for your new file: 





Bios a 
Cocoa Touch ET 

Es== Stonboara 
ro Resource 
E Other 
=| osx | 
a7 Cocoa 
A Cand C++ Application 
1 User Interface 
ii Core Data 


Figura 10.2: Localização do template de XIBs 


Save As: | LoginViewVisual.xib W 


Tags: 


Where: | [7] ViewCustomizada v 


Group | [a ViewCustomizada = 





Targets M A ViewCustomizada 
ViewCustomizadaTests 


| Cancel | | Create | 


Figura 10.3: Nomeando o arquivo XIB 


182 


Casa do Código Capítulo 10. Componentes gráficos customizados 








ATENÇÃO AOS NOMES 


Repare que tanto o nome da classe (arquivos .h e .m) quando o 
arquivo de interface ( XIB) chamam-se “ LoginViewVisual” - a única 
coisa que muda é a extensão. É muito importante prestar atenção a este 
detalhe, pois do contrário as coisas não funcionarão corretamente mais 





adiante. 


ViewCustomizada 
2 targets, iOS SDK 7.0 


[h] LoginView.h 
im) LoginView.m 
[À LoginViewvisual.h 





E LoginViewvVisual.m 

LoginViewVisual.xib 
Y [ ] ViewCustomizada 
h AppDelegate.h 
im AppDelegate.m 
B Main.storyboard 


= 




















Figura 10.4: Mesmo nome, extensões diferentes 











Agora abra o arquivo “ LoginViewVisual.xib’, e construa a tela da mesma 
maneira como já fizemos tantas outras vezes no livro. O tamanho do componente 
deve ser 300 pixels de largura, e 150 de altura. Para conseguir isso, certifique-se que 
o campo “Size” no Attributes Inspector esteja selecionado com a opção “Freeform”, 





conforme mostra a imagem 10.5. 
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EMTAK E d LO 


DB E vs O 


Simulated Metrics 








Freeform 











ar 


Status Bar None 





ar 


Top Bar | None 








ar 


Bottom Bar | None 





View 








Mode | Scale To Fill s 





Tag ol , 


Figura 10.5: Selecione ‘Freeform para conseguir alterar o tamanho no Interface Buil- 
der 


Nem tudo é mágica no mundo do iOS, e para o arquivo XIB saber que ele 
está associado a alguma classe, devemos informar o nome dela no campo “Cus- 
tom Class” do Identity Inspector ( View -> Utilities -> Show Identity 
Inspector) - no caso, “LoginViewVisual”. Veja a imagem 10.6 


gm mito 
DOA m T sS o 


ustom Class 





Identity 


Restoration ID | 
User Defined Runtime Attributes 


Key Path Type Value 


Figura 10.6: Nome da classe associada ao XIB 
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Crie a tela utilizando como referência a imagem 10.7 e, caso necessário, também 
o código anterior que fizemos para o arquivo “LoginView.m”. 





m| 4 D Bs ViewCustomizada > A] LoginViewVisual.xib » No Selection 
D Placeholders 

E5 File's Owner 

ri] First Responder 


v Login View Visual 


: Usuário 
v View 
__ Label - Usuário 
Label - Senha Senha 


-No Border Style Text Field - Infor... 


No Border Style Text Field - Infor... Ei 
Linha ogin 


Button - Login 


Figura 10.7: Construção da tela no Interface Builder 





CONECTE TAMBÉM OS OUTLETS 


Arquivos XIB, assim como Storyboards, representam apenas compo- 
nentes visuais, nada mais. Para que seja possível interagir com eles via 
código é preciso conectar todos os outlets e actions que forem necessá- 
rios. No caso da tela de login, crie outlets para os campos de login e 
senha. O seu arquivo .h deverá ficar assim: 


t import <UIKit /UlKit.h> 


Ginterface LoginViewVisual : UlView 
Oproperty (weak, nonatomic) IBQutlet UlTextField *userField; 


Oproperty (weak, nonatomic) IBQutlet UlTextField *passwordField; 
@end 











10.8 COMO UTILIZAR VIEWS CRIADOS COM ARQUIVOS XIB 


Ao contrário de componentes criados puramente com código, aqueles que te- 
nham arquivos XIB associados precisam ser obtidos de uma outra maneira, 
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através da classe NSBundle. Confira o código abaixo, referente ao arquivo 


ViewController.m: 


// ViewController.m 


- (void)viewDidLoad 
{ 
[super viewDidLoad] ; 
LoginViewVisual *lv = [[NSBundle mainBundle] 
loadNibNamed:@"LoginViewVisual" owner:self options:nil] [0]; 
CGRect lvFrame = lv.frame; 
lvFrame.origin = CGPointMake( 
(self.view.frame.size.width - lvFrame.size.width) / 2, 30); 
lv.frame = lvFrame; 
[self .view addSubview:lv]; 
} 


A diferença está nas linhas 6 e 7 onde, ao invés de instanciar a classe utilizando 
a dobradinha “alloc / init”, obtemos através do método loadNibNamed, da classe 
NSBundle. O resto do código é igual ao exemplo anterior. Rode o exemplo e veja o 


resultado. 


Não está idêntico? 


Você deve ter reparado que a tela não é exatamente igual à anterior - em especial, 
as bordas não estão arredondadas e o botão não tem o contorno preto. Esses deta- 
lhes somente podem ser feitos via código, e não pelo Interface Builder. Fica aqui, 
portanto, este desafio: utilizando os conhecimentos adquiridos até agora, faça o re- 
sultado visual do componente “LoginViewVisual? ser idêntico àquele obtido com 


“LoginView”. 
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CAPÍTULO 11 


Conceitos fundamentais de 
Objective-C 


Objective-C é, no fundo, C, mas C com esteroides. Mais precisamente, Objective-C 
adiciona um conjunto de extensões à linguagem C, como orientação a objetos. A 
sintaxe é particularmente diferente, mas tudo o que funciona em C irá funcionar 
em Objective-C, inclusive bibliotecas de terceiros que nem sabem da existência da 
“nova” linguagem. É também a principal forma de criar aplicativos para Mac OS X 
e iOS, tendo sido feita pela Apple em 1983. 

Aqui você pode revisar alguns conceitos, já que o enfoque do livro foi bastante 
prático. 


11.1 UMA PEQUENA HISTÓRIA 


Dependendo de como você encarar o aprendizado, Objective-C pode ser fácil e agra- 
dável, ou extremamente irritante e frustrante. Fácil e agradável é uma opção melhor, 
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mas eis uma pequena história: quando eu tive que aprender Objective-C para poder 
desenvolver aplicativos para iOS, eu nunca tinha visto a linguagem na frente, com 
exceção de algumas lidas rápidas em artigos online. A pressão para começar a criar 
aplicativos era imensa, precisávamos mostrar ao mercado que tínhamos um pro- 
duto para atender as demandas. Isso foi logo após o lançamento mundial do iPad, 
e até então encontrar desenvolvedores qualificados — ou ao menos interessados — 
em Objective-C e desenvolvimento para iOS no Brasil era algo extremamente difícil. 
Portanto, durante 6 dias seguidos, das 9 da manhã às o1 da manhã do dia seguinte, 
minha única tarefa durante o dia todo era estudar, tentando assimilar a avalanche de 
informação. 

Esta imersão de choque acabou ditando o desenrolar das próximas semanas. 
Olhando para trás, um dos maiores erros que fiz foi ter criado expectativas erra- 
das sobre como Objective-C deveria funcionar, especialmente em relação à sintaxe. 
Eu queria que a sintaxe fosse como Java, C#, C, Javascript, qualquer coisa assim, e 
demorei para aceitar que deveria encarar a linguagem como diferente. Muitos ar- 
tigos e livros descrevem Objective-C como sendo uma linguagem fácil de ler e de 
aprender (e talvez por isso eu tenha tido expectativas irrealistas), mas na prática não 
é exatamente assim. 

Portanto, o meu conselho de ouro para quem estiver aprendendo Objective-C: 
aceite a linguagem do jeito que ela é, e tente escrever o código da maneira mais orga- 
nizada que puder. A sintaxe é estranha e muitas vezes temos que dar mais voltas que 
o razoável. Mas é também uma linguagem poderosa, que, quando compreendida sua 
maneira de funcionar, torna-se agradável de trabalhar. Procure maneiras eficientes 
e produtivas de utilizá-la, mas não se revolte contra ela. 


11.2 NOME E ASSINATURA DO MÉTODO 


Estes dois termos são fáceis de confundir e, grande parte do tempo, é comum os de- 
senvolvedores referenciarem-se a eles como sendo a mesma coisa, porém existe uma 
diferença fundamental: o nome do método é composto pelas suas partes sem quais- 
quer referências aos tipos dos dados, enquanto a assinatura compreende o conjunto 
completo. Exemplo: 





Assinatura: - (void) criaEmpresaComNome: (NSString +) nome 


eNumeroFuncionarios: (int) quantidade 





Nome: criaFmpresaComNome:eNumeroFuncionarios: 


Métodos em Objective-C são um dos principais pontos de confusão e reclamação 
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por muitos usuários, principalmente nos primeiros contatos com a linguagem. Eles 
são feios, verbosos e parecem repetir partes, mas depois que pegamos o jeito é até 
possível ver uma certa elegância. As intenções expressas no código acabam ficando 
mais claras, evitando idas frequentes à documentação apenas para saber a que se 
refere cada um dos argumentos. 

Procure criar métodos semanticamente bons, que expressem de maneira clara a 
intenção e que sejam auto descritivos. Muitas vezes isso irá resultar em nomes mais 
longos, mas essa é uma prática comum, feita por todas bibliotecas. É importante 
utilizar a convenção já existente no ecossistema Objective-C. 

Além disso, embora tenhamos usado a palavra método em todo o livro, o termo 
correto em Objective-C é “mensagem” (message), pois a implementação de Orienta- 
ção a Objetos da linguagem é baseada no conceito de “envio de mensagens” Desta 
forma, nós não “invocamos um método”, mas sim “enviamos uma mensagem” a um 
determinado objeto. Este é um conceito importante, e embora na maior parte do 
tempo não faça diferença como este mecanismo funciona, é importante entender, 
mesmo que superficialmente, o que ocorre por trás dos panos. 

Diferente de muitas outras linguagens, em Objective-C o destino (“target”) da 
mensagem é decidido em tempo de execução, com o objeto interpretando a mensa- 
gem enviada. A principal consequência disso é que este sistema de envio de mensa- 
gens não faz verificação de tipos, e na prática podemos enviar qualquer mensagem 
a qualquer destino (ou, em outras palavras, podemos invocar qualquer método em 
qualquer objeto). Contudo, isso não significa que irá funcionar, pois caso um ob- 
jeto receba uma mensagem da qual não tem conhecimento, um erro em tempo de 
execução será gerado, muito provavelmente fazendo o aplicativo quebrar. Essa ca- 
racterística não deve ser encarada como negativa, muito pelo contrário, pois é um 
dos pilares que torna a linguagem dinâmica e permite desenvolver de formas que 
não são possíveis em outras linguagens. 

Contudo, durante todo o livro usamos a expressão “método” e “invocar” (como 
em “.. invocar o método criaUsuario”), ao invés dos termos semanticamente 
corretos segundo a especificação da linguagem. Eles são mais amigáveis ao público 
alvo, e acabam invariavelmente sendo utilizados pela maioria dos blogs e livros. 


11.3 PROPRIEDADES 


Um dos princípios de programação Orientada da Objetos é o encapsulamento, em 
que os atributos de uma classe nunca são acessados diretamente, mas sim através de 
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métodos. Muitas vezes surgem métodos de acesso e modificação — popularmente 
conhecidos como getters e setters —, o que permite controle sobre o gerenciamento 
de estado dos dados, além de expor apenas o que realmente é necessário. 

Isso é facilitado em Objective-C com o uso de propriedades. Propriedades pro- 
vêm uma sintaxe simples e limpa para métodos de acesso, além de tornar fácil a 
definição das regras de gerenciamento de memória e controle de concorrência múl- 
tipla. 

A declaração de propriedades é feita juntamente com os demais métodos da 
classe, protocolo ou categoria (estes dois últimos são abordados mais adiante neste 
capítulo), e tem uma sintaxe própria. Considere o exemplo abaixo, retirado da classe 





Empresa que já usamos neste livro: 


@property (nonatomic, retain) NSString *nome; 


A diretiva eproperty declara a propriedade, enquanto que os valores entre 
parêntese — (nonatomic, retain) — são opcionais (porém geralmente utiliza- 
dos) e provêm detalhes adicionais sobre o comportamento da propriedade. Utilizar 
uma propriedade é equivalente a declarar os métodos de acesso manualmente. Dessa 
forma, o código fica assim: 


Oproperty NSString *nome; 
é equivalente ao código: 


- (NSString *) nome; 
- (void) setNome: (NSString *) novoNome; 


A parte entre parênteses na declaração da propriedade pode ter os seguintes va- 
lores, que podem ser combinados com vírgula: 

Acesso readwrite informa que a propriedade pode ser utilizada tanto para 
leitura (getter) quanto para escrita (setter). Este é o valor padrão. 

readonly marca a propriedade como sendo apenas para leitura, ou seja, não 
será possível atribuir valores. 

Atribuição assign informa que uma atribuição simples será feita. Se utilizado 
em objetos, esta opção implica que, caso o valor original seja liberado da memória, a 
propriedade passará a referenciar “lixo”. Esta opção deve necessariamente ser usada 
caso a propriedade seja um tipo primitivo (como int e float) ou derivado de 
alguma struct, como CGRect. 
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retain determina que uma mensagem retain seja enviada ao objeto na hora 
de atribuir o valor. Desse modo, o objeto passa a participar do gerenciamento de 
memória. Caso a propriedade tenha algum outro valor na hora da atribuição, uma 
mensagem release será enviada a ele. Esse funcionamento é especialmente útil, 
pois evita que tenham de lidar com essas questões explicitamente. 

copy é um atributo de uso mais restrito, no qual a atribuição é feita através do 
envio da mensagem copy, sendo ainda válido apenas para tipos que implemen- 
tem o protocolo NSCopy ing. O valor anterior da propriedade recebe a mensagem 
release antes do novo valor ser atribuído. 

Acesso concorrente Por padrão, todo acesso à propriedade é feito de maneira 
atômica, com proteção de acesso concorrente. Na prática isso significa que apenas 
uma thread por vez terá acesso a ela. Caso o seu programa não tenha essa necessidade 
(o que é 99% dos casos), utilize o atributo nonatomic. 

Uma coisa boa para nós é que com propriedades não precisamos necessaria- 
mente declarar variáveis de instância. Contudo, você pode estar se perguntando: 
“mas sendo assim, propriedades não acabam sendo exatamente a mesma coisa que va- 
riáveis de instância públicas”. Esta é uma observação bastante interessante, e para 


entender o porquê de não ser a mesma coisa, veja os exemplos a seguir. 


11.4 ACESSO SOMENTE LEITURA 


O acesso às propriedades pode ser configurado para não permitir mudanças no valor, 
pelo menos não para qualquer código que não seja o da própria classe: 


1 // Empresa.h 

2 Qinterface Teste : NSObject 

3 Gproperty (nonatomic, readonly) double lucroAnual; 
4 @end 

5 

6 // Empresa.m 

7 (implementation Empresa 

8 

o -(id) init { 


10 if ((self = [super init])) { 

n // Repare no uso de underline ("_") 
12 _lucroAnual = 100; 

13 } 
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return self; 


- (void) calculaLucroAnual { 
// Internamente podemos modificar a variável 
// sem qualquer tipo de restrição 
_lucroAnual = 3500; 


} 
@end 


// OutraClasse.m 
Empresa *e = [[Empresa alloc] init]; 


// OK, estamos lendo apenas. Imprime "100" 
NSLog(@"Lucro atual: %f", e.lucroAnual); 


// Erro, "lucroAnual" é "readonly" 
e.lucroAnual = 700; 


[e calculaLucroAnual] ; 


// Imprime "3500" 
NSLog(0"Lucro recalculado: Kf", e. lucroAnual); 


«o» 


Repare que nas linhas 12 e 21 foi utilizado um underline (É ”) como prefixo da 


propriedade lucroAnual. Isso é possível devido a uma funcionalidade do com- 
pilador chamada “Propriedades automáticas” (do inglês “Auto Properties”), one ele 
automaticamente “declara” a variável com underline para poder ser utilizada dentro 


c 


da classe onde foi definida. Você pode ainda utilizar “ self .lucroAnua1” nas li- 
nhas 12 e 21, porém nas linhas 29, 32 e 37 não pode usar o prefixo com underline, pois 


aquele é um código externo a classe “Empresa”, onde a property foi declarada. 


Código customizado para o getter ou setter 


Caso haja necessidade, você pode sobrescrever a implementação do método 
getter ou setter (ou ambos). Imagine que um Chuveiro tenha limites de 


temperatura que não possam ser ultrapassados: 


// Chuveiro.h 
Qinterface Chuveiro : NSObject 
@property (nonatomic, assign) int temperatura; 
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@end 


// Chuveiro.m 
@synthesize temperatura; 


-(void) setTemperatura: (int) valor { 
// Evita que o chuveiro congele ou queime a pessoa 
if (valor < 10 || valor > 30) { 
@throw [NSException exceptionWithName:@"Argumento inválido" 
reason:@"A temperatura deve ser entre 10 e 30 graus" 
userInfo:nil]; 


// Repare no underline 
-temperatura = valor; 


A regra de nomenclatura é setNomeDaPropriedade, tomando o cuidado de 
que o primeiro caractere do nome da propriedade neste caso tem que ser em caixa 
alta. Fazendo dessa forma, o Objective-C sabe que deverá utilizar o seu método 


setPosicao:. 


11.5 UTILIZANDO PROPRIEDADES DENTRO DA PRÓPRIA 
CLASSE 


Embora possa parecer contraintuitivo, existe uma diferença singular — mas impor- 
tante — na maneira como acessamos propriedades dentro: da classe onde foram de- 
finidas, através da palavra-chave self: 


1 // Chuveiro.h 

2 Qinterface Teste : NSObject 

3 Gproperty (nonatomic, assign) int temperatura; 
4 

s -(void) acessaViaPropriedade; 

é -(void) acessaDireto; 


7 


s @end 


9 


10 // Chuveiro.m 
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Cimplementation Teste 


- (void) acessaViaPropriedade 1 
self .temperatura = 15; 


- (void) acessaDireto { 
-temperatura = 99; 


- (void) setTemperatura: (int) novaTemperatura { 
NSLog (0"Mudando a temperatura de kd para %d", temperatura, 
novaTemperatura) ; 
-temperatura = novaTemperatura; 


} 
@end 


Na linha 14 estamos acessando a propriedade de fato, através de self. Desta 
forma, todas as regras definidas na declaração da propriedade na linha 3 são aplica- 
das — por exemplo, se tivéssemos definido-a como readonly, não seria possível 
fazer self .temperatura = 15. Na linha 21 sobrescrevemos o método setter da 
propriedade para adicionar logs. Na linha 18 não usamos self, o que na prática 
acaba funcionando como se _temperatura neste caso fosse uma variável de ins- 
tância como qualquer outra. Repare que, como mencionado anteriormente, o com- 
pilador automaticamente cria variáveis com o nome da propriedade prefixadas com 
underline, que podem ser acessadas dentro da classe onde foram declaradas. 


// OutraClasse.m 
Chuveiro *c = [[Chuveiro alloc] init]; 


[c acessaViaPropriedade]; 
[c acessaDireto] ; 
NSLog(0"Temperatura atual: %d", c.temperatura); 


O resultado deste programa é: 


Mudando a temperatura de O para 15 
Temperatura atual: 99 
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11.6 DEFININDO PROTOCOLOS 


Protocolos são para Objective-C o que interfaces são para Java e C&: eles determinam 
um contrato que as classes que fizerem uso deles seguem. Protocolos permitem a 
definição de métodos opcionais, ao contrário de Java e Cx, onde todos os métodos 
devem ser implementados. Isso significa que, na prática, um Protocolo representa 
um contrato que pode ter cláusulas opcionais, e portanto é necessário tomar algumas 
precauções na hora de lidar com eles. Chamamos este tipo de protocolos informais, 
em contraste aos protocolos formais, que são aqueles de implementação obrigatória. 

Protocolos também permitem aplicar o conceito de herança múltipla em 
Objective-C, pois é possível que uma mesma classe atenda a diversos protocolos de 
uma única vez, enquanto que só pode herdar de uma única classe. 

Protocolos informais contêm uma lista de métodos que as classes podem optar 
ou não por implementá-los, o que é bastante útil para a implementação de delega- 
tes (delegadores, que são demonstrados mais adiante neste capítulo). Por exemplo, 
imagine um componente de rolagem de conteúdo (scroll), que tem eventos para cada 
mudança na posição do conteúdo, nível de zoom e estado da animação de rolagem. 
Com a utilização de um protocolo informal, diferentes classes podem lidar apenas 
com os eventos que lhe interessam, sem precisar se preocupar em prover implemen- 
tações vazias dos outros métodos. 

Em contrapartida, protocolos formais definem um conjunto de métodos que de- 
vem obrigatoriamente ser implementados, o que é verificado pelo compilador. Um 
exemplo de uso deste tipo de protocolo é uma classe responsável por realizar down- 
load de arquivos, que determina que um método downloadFinalizado seja obri- 
gatoriamente implementado, caso contrário não seria possível disponibilizar às clas- 
ses o arquivo baixado. 

Não existe uma regra sobre quando utilizar protocolos formais ou informais, 
sendo possível inclusive combiná-los em um único protocolo misto. 

Você pode tentar definir o protocolo em um arquivo de cabeçalho (extensão .n) 
próprio, como em conjunto com a definição de uma classe. No caso de utilizar um 
arquivo de cabeçalho próprio, não é necessário a criação do arquivo .m — afinal, o 
protocolo define apenas o contrato. 

A sintaxe é a seguinte: 


@protocol EventosDeDownload <NSObject> 

- (void) downloadFinalizado: (NSData *) conteudo; 
- (void) downloadErro: (NSError *) erro; 

Gend 
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Por padrão todos os métodos de um protocolo são de implementação obrigató- 
ria. Caso você queira que alguns (ou todos) sejam opcionais, utilize a palavra-chave 
Goptional: 


// Arquivo "EventosDeDownload.h" 
Gprotocol EventosDeDownload <NSObject> 
- (void) downloadFinalizado: (NSData *) conteudo; 


// Todos os métodos definidos daqui para baixo serão opcionais 
Coptional 

- (void) downloadErro: (NSError *) erro; 

@end 


Se você quiser ser explicito, pode utilizar a palavra-chave @required para mar- 
car os métodos que devem ser obrigatoriamente implementados. Para implementar 
um protocolo, a sintaxe é a seguinte: 


# import "EventosDeDownload.h" 
Qinterface Algumallasse : NSObject<EventosDeDownload> 
@end 


Para implementar diversos protocolos, basta separá-los por vírgula: 








ENSObject<EventosDeDownload, OutroProtocolo>. Agora é só im- 
plementar os métodos na classe respeitando a assinatura do método conforme 
definido na declaração do protocolo: 


// Arquivo AlgumaClasse.m 
@implementation AlgumaClasse 


- (void) downloadFinalizado:(NSData *) conteudo { 


- (void) downloadErro:(NSError *) erro { 


@end 
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UMA NOTA SOBRE <NSOBJECT> 





Na declaração do protocolo EventosDeDownload foi adicionada a 
instrução <NSObject >, o que literalmente significa que o protocolo em 
questão implementa o protocolo Nsobject (não confundir com a classe 
Nsobject). Embora isso não seja obrigatório, é uma prática sempre de- 
clarar desta forma, pois permite a utilização de métodos como retain 
e release, assim como outros métodos definidos em NSobject. 











11.7 TRABALHANDO COM CATEGORIAS 


Uma das funcionalidades mais poderosas e úteis do Objective-C são as Categorias, 
que permitem estender as funcionalidades de qualquer classe, assim como substituir 
métodos já existentes. Categorias geralmente são criadas em seus próprios arquivos, 
embora seja possível adicionar várias em um mesmo arquivo-fonte, pois o compi- 
lador do Objective-C não impõe regras desta linha (ao contrário de Java). Além de 
poder adicionar e substituir métodos de qualquer classe, esta funcionalidade da lin- 
guagem pode atuar também como uma maneira de organizar o projeto, distribuindo 
a implementação da classes em arquivos distintos, agrupados por responsabilidade 
— ao contrário de colocar tudo em um único arquivo gigantesco. Elas também são 
úteis para declarar métodos privados em alguma classe sua. 

Qualquer que seja o seu motivo, Categorias são extremamente poderosas e sim- 
ples de utilizar, e do ponto de vista do programa, elas funcionam como se perten- 
cessem à classe original, podendo inclusive acessar qualquer propriedade e método, 
inclusive os privados. É possível adicionar métodos tanto para as suas próprias clas- 
ses, quanto para as classes da própria API oficial da linguagem, e não é necessário 
ter o código-fonte da classe. Por via de regra, não é possível adicionar variáveis à 
classe, apenas métodos — contudo, existem alguma técnicas que permitem simular 
o comportamento de variáveis de instância, o que é igualmente útil. 

C& e VisualBasic.NET têm um recurso similar chamado Extension Methods, em- 
bora não permitam o acesso a membros privados. Já a comunidade Ruby se refere a 
isto como Monkey Patching (que na verdade é uma definição do conceito, não sendo 
exclusivo de Ruby). 

Como primeiro exemplo, vamos adicionar um método na classe NSSt ring para 


inverter o conteúdo da string: 
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// Arquivo NSString+Customizacoes.h 
QGinterface NSString (Customizacoes) 
- (NSString *) inverter; 

@end 


Não existe uma regra para o nome dos arquivos, porém um padrão comu- 
mente utilizado é <NomeDaClasse>+<NomeDaCategoria>.extensão, que no nosso 
caso virou NSString+Customizacoes.h. Na linha 2, repare que declaramos a 
@Qinterface com o mesmo nome da classe NSString, porém com uma diferença 
muito importante: a adição de (Customizacoes), que é a maneira como as cate- 
gorias são declaradas em Objective-C. Você pode utilizar qualquer string dentro dos 
colchetes, desde que use o mesmo valor no arquivo de implementação, conforme o 
código abaixo: 


// Arquivo NSString+Customizacoes.m 
Cimplementation NSString (Customizacoes) 


- (NSString *) inverter { 
char tmp[self.length + 1]; 


for (int i self.length - 1; i >= 0; i--) { 
[self characterAtIndex:i]; 


tmp[self.length - i - 1] = c; 


char c 


tmp[self.length] = '\0'; 
return [NSString stringWithUTF8String:tmp] ; 


@end 


O código da listagem acima é autoexplicativo, apenas atente ao deta- 
lhe que a declaração da Q@implementation contém o nome da categoria ( 
(Customizacoes)) exatamente da mesma forma como foi declarada no arquivo 
.h. O método inverter agora está acessível diretamente na classe NSSt ring: 


NSString *s = O"uma palavra"; 
NSLog(o"ko", [s inverter]); // Resultado: "arvalap amu" 


Categorias também são muito úteis para tornar mais fáceis códigos repetitivos. 
Um bom exemplo disso é a manipulação das propriedades de tamanho e posição 
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de uma UIView. Considere por um instante o código abaixo, que não faz uso de 
categorias: 


// Obtêm a posição atual da view 
float x = self.view.frame.origin.x; 


// Diminui pela metade a posição 
CGRect frame = self.view.frame; 
frame.origin.x = x / 2; 
self.view.frame = frame; 


Embora o código da linha 2 não seja complicado, e ocupe apenas uma linha de 
código, ainda assim é bastante chato ter que passar por diversas propriedades até 
obter a posição “x” da view. Já o código das linhas 5 a 7 já é muito mais entendiante, 
e tê-lo que repetir diversas vezes durante o ciclo do programa é algo frustrante. Com 
categorias podemos simplificar bastante o processo: 


// Arquivo UlView+AdicoesFrame.h 
Qinterface UlView (AdicoesFrame) 


- (void) setX: (float) newX; 


// Em Objective-C evita-se o padrão "getX" de outras linguagens 
-(float) x; 


@end 


// Arquivo UIView+AdicoesFrame.m 
@implementation UIView (AdicoesFrame) 


- (void) setX: (float) novoX { 
CGRect frame = self.frame; 


frame.origin.x = novoX; 
self.frame = frame; 


-(float) x 1 
return self.frame.origin.x; 


@end 
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Tendo feito este código, a manipulação da view fica muito mais simples: 


UlView *v = [[UIView alloc] init]; 
v.x = 45; 


float posicaoX = v.x; 


Você pode estender a mesma abordagem para outras propriedades, como y, 
widthe height. 


11.8 (GERENCIAMENTO DE MEMÓRIA 


Todo aplicativo, independentemente da linguagem em que foi desenvolvido e da pla- 
taforma que roda, precisa lidar com gerenciamento de memória — o que muda, po- 
rém, é quem é responsável por esta tarefa. Em Java e C# isso vem “de graça” na forma 
de um coletor de lixo automático, assim como Ruby. Por outro lado, C, C++ deixam 
esta tarefa para o próprio desenvolvedor. Já com Objective-C a resposta é “depende”, 
pois existem dois conceitos: gerenciamento manual, e gerenciamento automático. 

Toda aplicação que for criada a partir do Xcode 5 automaticamente terá habili- 
tada por padrão o suporte a gerenciamento automático de memória, do termo ARC 
- “Automatic Reference Counting” (algo como “contador automático de referências”). 
Fazer uso de ARC é a maneira recomendada de construir aplicações modernas, ha- 
vendo raríssimos motivos para não utilizá-lo. Não é necessário nenhuma configu- 
ração especial no seu projeto, o próprio Xcode já prepara o ambiente com suporte a 
ARC. 





OBJECTIVE-C EM IOS VERSUS MAC VERSUS CONTADOR DE RE- 
FERÊNCIAS 


Em Mac existe o conceito de coletor de lixo (do inglês “garbage col- 
lector”), porém isso ainda não é realidade em iOS. Com o suporte a ARC 
no iOS, o compilador se encarrega de colocar as chamadas aos métodos 
de liberação de memória nos devidos lugares. Embora não chegue a ser 
um coletor de lixo propriamente dito, é uma grande mão na roda. Para 
utilizar esse recurso é necessário realizar algumas configurações especi- 
ais no projeto, além de tomar alguns cuidados na hora de desenvolver. 
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Apesar de parecer assustador, a realidade é muito mais tranquila, bastando seguir 
algumas receitas de bolo bastante simples para que tudo funcione em harmonia. 


Contando referências 


Objective-C trabalha com o conceito de contador de referências, em que, ao ins- 
tanciar o objeto e toda vez que alguém o retém, um contador interno é incrementado. 
E quando uma mensagem para que seja liberado é executada, o contador é decre- 
mentado. Quando ele chegar em zero, a memória é liberada. A figura 11.1 exemplifica 


este conceito. 


=o cm ppm) 














alloc/init a ki release 
æ ii. A - Mm si 1 > a -X Destroyed 
27 


Retain count=1 pr di 20 he 
id ice ds = Mm Ca a CO SNS -X Destroyed 
= 2º 


EN release 


Figura 11.1: Exemplificação do contador de referências. Fonte: Apple 


Como ARC é a maneira recomendada e padrão de criar projetos modernos 
para iOS, isso é tudo o que você precisa saber sobre gerenciamento de memó- 
ria. Confie no compilador e ele fará todo o trabalho pesado para você. Caso esteja 
curioso, a imagem 11.2 mostra onde habilitar ou desabilitar o suporte a ARC. 
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fm) AppDelegate.m Y App) VM 5.0 - Language - Objective C 
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[h] ViewController.h Objective-C Automatic Reference Counting Yes $ 
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[E] Images.xcassets 
» [|] Supporting Files 


Figura 11.2: Chave de configuração para ARC - “Yes é o padrão 


11.9 GERENCIAMENTO MANUAL DE MEMÓRIA (PARA OS CU- 
RIOSOS) 


Embora você sempre deva desenvolvedor seus projetos utilizando ARC (que é o pa- 
drão), esta seção irá descrever como funciona o gerenciamento manual de memória 
em Objective-C, tanto por razões históricas quanto para você compreender melhor 
o que se passa nos bastidores. 

Caso queira, pode pular para a próxima seção sem medo. Na prática são bem 
remotas as chances de você ter que manualmente fazer o gerenciamento de memória. 

Decidiu continuar a ler? Então vamos lá. Tudo se resume a três regras bastante 
simples e um pouco de atenção do desenvolver, nada mais. E, se algo der errado, o 
máximo que acontecerá é o seu aplicativo quebrar imediatamente, ou vazar memória 
até que eventualmente quebre. 

As regras são: 


e Se você é o dono, libere; 
e Se você não é o dono, não libere; 
e Sobrescreva o método dealloc em suas classes, para liberar as variáveis que 
possuir. 
Primeira regra: quando você é o dono 


Você é considerado “dono” de algum objeto quando utiliza explicitamente os 
métodos alloc, copy, newou retain. Exemplo: 


1 NSArray *dados = [[NSarray alloc] init]; 


2 
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// Trabalha com o NSArray 


// Regra: somos donos, então liberamos 
[dados release]; 


Na linha ı utilizamos alloc, portando precisamos liberar a nossa parte, através 
do método release na linha 3. A respeito de retain, veja a regra 3. 


Segunda regra: Se você não é o dono, não libere 


Basta seguir a lógica inversa da primeira regra. Se você tem ou cria algo, mas não 
usou alloc, new, copy ou retain, deixe para lá. Por exemplo: 


NSMutableDictionary *config = [NSMutableDictionary dictionary]; 
[config setObject:O"true" forKey:0"acesso.seguro"]; 
[config setObject:0"superSenha2000" forkey:0"senha.db"] 


// Não é necessário fazer nada para liberar 


Quando construímos o NSMutableDictionary na linha 1 da listagem ante- 
rior, não existe nada de alloc nem nenhum de seus parentes, portando não precisa- 
mos nos preocupar em liberar a memória manualmente — magia negra (ou alguma 
coisa assim) resolve o problema. 


Terceira regra: Libere memória no método dealloc 


Enquanto que em variáveis locais a memória também deve ser liberada no es- 
copo do bloco de código, em variáveis de instância e nas marcadas com Gproperty 
a liberação deve ocorrer num método especial chamado dealloc, o qual você 
deve sobrescrever. Para simplificar a explicação, considere uma hipotética classe 
CarrinhoCompras, a qual pertence aum Cliente e pode conter diversos itens: 


// CarrinhoCompras.h 
@interface CarrinhoCompras : NSObject { 
NSMutableDictionary *cache; // Algum cache para operacoes internas 


Cproperty (nonatomic, retain) Cliente *cliente; 
@property (nonatomic, readonly) NSMutableArray *itens; 
Oproperty (nonatomic, assign) BOOL estaPago; 
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@end 


// CarrinhoCompras.m 
Cimplementation CarrinhoCompras 


-(id) init { 
if ((self = [super init])) { 
_itens = [[NSMutableArray array] retain]; 
cache = [[NSMutableDictionary alloc] init]; 


return self; 


-(void) dealloc { 
[_cliente release]; 
[cache release]; 
[_itens release]; 
[super dealloc]; 


} 
@end 


Para sabermos quais membros da classe precisam de gerenciamento manual 
de memória basta aplicar as regras do item 1, com a diferença que as chamadas a 
release devem ser feitas no método dealloc, conforme as linhas 25 a 28. Note 
que, nas linhas 17 e 18 iniciamos as variáveis itens e cache com retaine alloc 
respectivamente, e ambas se encaixam na primeira das regras que vimos. Contudo, 
o membro cliente está declarado de uma maneira ligeiramente diferente, através 
do uso de Eproperty com o modificador retain - neste caso, o Objective-C se 
encarrega de parte do trabalho para nós, porém ainda assim é necessário o código da 
linha 25, caso contrário o contador de referências não seria decrementado. Se, por 
outro lado, usássemos assign, então não poderíamos invocar release. 

Quando dealloc é executado? dealloc é executado automaticamente quando 
for necessário. Contudo, você nunca pode chamar dealloc diretamente, exceto 
no caso de [super dealloc]; (linha 28), que é obrigatório. Lembre-se: use 
release para informar que você está liberando o objeto, e não dealloc. 
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ARC PRECISA ESTAR DESABILITADO 


Para usar retaine release o suporte a ARC precisa estar desa- 
bilitado. No mesmo lugar mostrado mais acima na imagem 11.2, mude 
a opção para “NO” Contudo, tenha em mente que cada vez mais bibli- 
otecas de terceiros estão sendo atualizadas para utilizar ARC também, 
o que resultaria em diversos erros de compilação caso esta configuração 
seja desabilitada. 

Na prática, é muito difícil conseguir combinar código ARC com có- 
digo não ARC - é possível, mas igualmente fácil de dar algum tipo de 
problema. 











11.10 SIMPLIFICANDO AS COISAS COM LITERAIS 


Uma das funcionalidades introduzidas no Xcode 4.5 é o conceito de literais (do in- 
glês Literals), que é uma maneira bem mais simples e prática de iniciar coleções de 
objetos NSArray e NSDictionary, além da construção com menos código de 
objetos NSNumber. 


Literais para NSNumber 


A classe NSNumber é muito utilizada para encapsular tipos primiti- 
vos ( char, short, int, long, long long, float, double, BOOL e 





bool) para que possam ser passados como argumentos para métodos que esperam 
objetos. Historicamente isso tinha que ser feito da seguinte maneira: 


// Encapsulando tipos primitivos em um NSNumber da maneira tradicional, 
// existente até o Xcode 4.4 

NSNumber *+letra = [NSNumber numberWithChar:'A']; 

NSNumber *inteiro = [NSNumber numberWithInt:42]; 

NSNumber *yes = [NSNumber numberWithBool:YES]; 


Já com o Xcode 4.5 o mesmo código pode ser escrito da seguinte forma: 


// Mesmo código feito no Xcode 4.5 em diante 
NSNumber *letra = @'A'; 

NSNumber *inteiro = 042; 

NSNumber +yes = OYES; 
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A diferença está em adicionar o caracter * @ na frente do valor a ser atribuído. 


Literais para NSArray 


As coisas ficaram bem mais simples para criar instâncias de NSArray também, 
pois até o Xcode 4.4 a inicialização somente poderia ser feita da seguinte forma: 


// Criando NSArrays até o Xcode 4.4 
NSArray *frutas = [NSArray arrayWith0bjects:0"laranja", O"maçã", 
O"limão", @"melão", O"morango", nil]; 


NSString *morango = [frutas objectAtIndex:4]; 


NSArray *codigos = [NSArray arrayWithObjects: 
[NSNumber numberWithInt:33], 
[NSNumber numberWithInt:4345], 
[NSNumber numberWithInt:999], 
[NSNumber numberWithInt:17], 
nil]; 


int dezessete = [ [codigos objectAtIndex:3] intValue]; 


Já a partir do Xcode 4.5 o mesmo código pode ser feito de maneira muito mais 


sucinta: 


// Mesma construção, no Xcode 4.5 em diante 
NSArray *frutas = O[0"laranja", @"maçã", 

O"limão", O"melão", O"morango"]; 
NSString *morango = frutas[4]; 


NSArray *codigos = 0[033, 04345, 099, 017]; 
int dezessete = codigos[3]; 


A regra éa mesma do NSNumber, bastando prefixar os valores com o caracter * E” 
Além disso, para acessar um determinado item pelo índice basta colocar o valor entre 
colchetes, ao invés de utilizar o método objectAt Index. Um detalhe importante é 
que esta forma de inicialização irá criar apenas objetos imutáveis. Para criar instância 
de um NSMutableArray (que permite adicionar ou remover objetos a qualquer 
momento) faça da seguinte forma: 


NSMutableArray *codigos = 
[NSMutableArray arrayWithArray:0[045, 098, 01234]]; 
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[codigos addObject:0[0897]]; 
[codigos addObject:0[0333]]; 


[Literais para NSDictionary] Outra classe que tira grande proveito de literais 
éa NSDictionary, pois além dos valores em si é necessário especificar as chaves 
para cada um dos valores, o que torna o código um tanto chato de ler, conforme 
mostrado abaixo: 


// Criando e acessando NSDictionary até o Xcode 4.4 
NSDictionary *dados = [NSDictionary 
dictionaryWith0bjectsAndkeys:O"valor1", QO"chavel" 
O"valor2", O"chave2", 
O"valor3", O"chave3", 
O"valor4", O"chave4", 
nill; 


NSString *valorChave2 = [dados objectForKey:@"chave2"]; 


Utilizando os literais a partir do Xcode 4.5, o mesmo código pode ser escrito da 
seguinte forma: 


// Versão Xcode 4.5 em diante 

NSDictionary *dados = @{ 
@"chave1" : O'"valor1", 
@"chave2" : @"valor2", 
O"chave3" : @"valor3", 
O"chave4" : @"valor4", 


+; 
NSString *valorChave2 = dados [0"chave2"]; 


A inicialização foi simplificada com o uso de @{}, e a separação entre 
chave e valor é feita com o caractere dois-pontos (“:”). De maneira similar ao 
NSArray, uma determinada chave pode ser acessada utilizando colchetes (como 


dados [E"chave2"]) ao invés do método objectForkey:. 
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CAPÍTULO 12 


Como criar uma conta no portal de 
desenvolvimento da Apple 


A Apple disponibiliza, através do iOS Developer Program, a suíte completa de fer- 
ramentas, documentação e códigos de exemplo para você desenvolver e distribui 
aplicativos para iOS. Para começar a criar aplicativos tudo o que você precisa fazer é 
criar uma conta grátis no site de desenvolvedores. 


12.1 REGISTRE-SE COMO UM DESENVOLVEDOR APPLE 


O primeiro passo é se registrar como um desenvolvedor Apple, o que pode ser feito 
de duas maneiras distintas: criando um Apple ID do zero, ou então utilizar o seu 
login existente do iTunes (o mesmo utilizado para baixar aplicativos da App Store, 
caso você tenha um iPhone, iPod Touch ou iPad). O resultado final de ambos os 
processos é o mesmo. 


Se você já tem um Apple ID basta acessar o endereço http://developer.apple.com/ 
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devcenter/ios, clicar no botão Log in e fornecer as mesmas credenciais utilizadas para 
baixar aplicativos na App Store. Simples assim. 

Caso você ainda não tenha um Apple ID acesse o link https://developer.apple. 
com/programs/register e clique no botão Create Apple ID. Note que todas as infor- 
mações devem ser inseridas em inglês, evitando caracteres acentuados. Informe da- 
dos como e-mail, senha, endereço e o que mais for solicitado. Se não souber o que 
preencher no campo Company / Organization, informe Private. No final do pro- 
cesso a Apple enviará um email para o endereço informado; abra-o e clique no link 
de verificação. 

Depois que você criou a sua conta ou entrou com uma existe, será solicitado 
algumas informações gerais sobre você, como perfil profissional e para quais plata- 
formas Apple presente desenvolver, conforme mostra a figura 12.1. Obs: caso você 
utilize uma conta Apple criada anteriormente, pode acontecer de não aparecer a tela 
da imagem 12.1, e sim cair direto no “IOS Dev Center”. Neste caso as informações 
devem ter sido inseridos em algum outro momento. 


Register as an Apple Developer 


Tell us about yourself. 


Primary Role and Experience 





What role best describes you? ( Software Engineer $ 


When did you start developing for Apple platforms? ( 2013-Present $ 





What are you developing? 


Select all that apply 


ios osx Web Technologies 

* Apps (App Store) * Apps (Mac App Store) Dashboard Widgets 
Apps (Custom B28) * Apps (Outside Mac App Store) iAd Advertisements 

* Apps (In-house) Application Plug-ins iBooks Content 


Figura 12.1: Primeira parte do processo de criação do Apple ID 
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12.2 FAZENDO A ASSINATURA NO IOS DEVELOPER PRO- 
GRAM 


Acesse o endereço https://developer.apple.com/devcenter/ios para ter acesso a todos 
os downloads, documentação e códigos de exemplo. 

Enquanto que o acesso ao portal de desenvolvimento, juntamente com as ferra- 
mentas e documentação são disponibilizadas gratuitamente pela Apple, para rodar o 
aplicativo em dispositivos e distribuí-lo na App Store é necessário fazer a assinatura 
do iOS Developer Program, independentemente se o seu aplicativo será gratuito ou 
pago. A assinatura deste programa de desenvolvimento é anual, e custa US$ 99,00 
tanto para pessoas físicas quanto para empresas. 





ASSINATURA VERSUS CONTA GRÁTIS 


Para começar a desenvolver aplicativos para iOS não é necessário re- 
alizar a assinatura do iOS Developer Program, bastando apenas o cadas- 
tro simples explicado anteriormente neste capítulo, que permite rodar os 


aplicativos no simulador que é instalado com o Xcode. 











Para realizar a assinatura, acesse o endereço https://developer.apple.com/ 
programs/ios e clique no botão Enroll Now. O processo todo é feito da seguinte 
forma: 


Fornecer os dados de acesso 


A primeira parte, identificada como Sign in or create an Apple ID, consiste em 
informar se você deseja realizar o cadastro com um Apple ID existente ou criar um 
novo. Considerando que você já tem o Apple ID, selecione a opção Sign in with your 
Apple ID e continue. Obs: caso já esteja logado no portal de desenvolvimento, você 
verá a opção “Existing Apple ID” com um botão “Continue”. Clique nele se for o seu 
caso. 


Assinar uma conta individual ou como empresa 


É possível realizar a assinatura como pessoa física (conta individual), ou como 
empresa, sendo que a principal diferença entre elas é que uma conta individual per- 
mite que apenas um desenvolvedor (você) tenha permissão para acessar o portal de 
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desenvolvimento, enquanto que a conta empresarial permite criar times de desen- 
volvedores. Selecione a opção Individual no fim da página, e forneça o seu Apple ID 
e senha caso solicitado. 


Informações pessoais para validação de segurança 


Após realizado o login irá aparecer uma tela com o título Enter your billing in- 
formation for identity verification, conforme mostrado pela figura 12.2. Na primeira 
parte, chamada Your Name, informe o seu nome exatamente como aparece no seu 
cartão de crédito internacional que será utilizado para realizar o pagamento da as- 
sinatura mais adiante, e em Your credit card billing address informe o endereço de 
correspondência da fatura do cartão de crédito. Clique em Continue. 


é Developer Apple Developer Program Enrollment 


O—e 
Enter Account Info 


Enter your billing information for identity verification 


{All form fields are required) 


Please enter your information using plain text. 
Diacritical characters will be converted to English characters (for example: u instead of ù, n instead of ñ) 


Your Name 





IMPORTANT - Enter your name EXACTLY as it appears on the credit card you intend to use during the Apple 
Online Store purchase process. Please do not use an abbreviation or nickname unless this is how your name 














appears on your credit card. 
Title Select one $ 
First Name Rafael 
Middle Name 
Last Name Steil 


Figura 12.2: Informações pessoais 
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Selecionar o tipo de assinatura 


A próxima tela, demonstrada na figura 12.3, pede para informarmos qual assi- 
natura desejamos fazer. Selecione iOS Developer Program (US$99 /year) e clique no 
botão “Continue” 


é Developer Apple Developer Program Enrollment 
o————o 
Enter Account Info Select Program 


Select your program. 


iOS Developer Program 
US$99 /year 

w The iOS Developer Program provides a complete and integrated process for developing and distributing apps 
for iPad, iPhone, and iPod touch. 


EE 
IA, 


Figura 12.3: Selecionar o programa 


Revisar as informações 


A próxima tela, Review your enrollment information & submit, pede apenas para 
você verificar se todas as informações fornecidas até o momento estão corretas. Pode 


continuar. 


Contrato padrão 


A tela Program License Agreement pede para você ler e aceitar o contrato padrão 
que é apresentado. Selecione o checkbox confirmando o aceite e clique no botão 1 
Agree. 


Dados do cartão de crédito 


Na tela “Enter your payment information” você deve inserir os dados do seu car- 
tão de crédito internacional, como em qualquer outra loja de ecommerce. Preencha 
as informações solicitadas e clique em “Continue” no final da página. A próxima tela 
lhe apresentará um resumo de todas as informações inseridas até agora, revise se está 
tudo OK e clique no botão “Place Order”, conforme a imagem 12.4. 
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Member Information 


Name: Rafael Steil 


Email: rafaelWexample.com 


Enrollment ID: G2JKLEV36D87 Guarde este código 


= acl [O Piaceorder | 


Figura 12.4: Código de identificação da sua conta, guarde-o muito bem 





GUARDE MUITO BEM O ENROLLMENT ID 


Atenção: guarde muito bem o código do Enrollment ID, pois eles se- 
rão necessários para a renovação da assinatura nos próximos anos. A Ap- 
ple não disponibiliza em nenhum outro lugar este código, porém solicita- 
o no processo de renovação. 











Ao final, você será apresentado com uma tela como a da imagem 12.5. A Apple 
diz levar até dois dias úteis para processar os eu cartão de crédito, porém é bastante 
comum eles errarem ou simplesmente esquecerem o seu pedido, por mais absurdo 
que isso possa parece. Se passar muito tempo do prazo e você não tiver respostas, 
ligue no suporte técnico da Apple nos Estados Unidos (infelizmente não há canal 
direto de atendimento no Brasil) e relate o ocorrido. Já aconteceu da Apple cobrar 
mais de uma vez o mesmo pedido, e frequentemente passam dias sem dar qualquer 
informação, portanto o melhor canal é via telefone. 
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Thank you. 


Order Details Dec 22, 2013 
Purchase Items 


iOS Developer Program $99.00 


Membership for one yea! 


Your order will be charged in US dollars Order Total: $99.00 


Figura 12.5: Tela final 


12.3 OS TIPOS DE CERTIFICADOS 


Todo aplicativo que roda no iOS precisa ser assinado digitalmente com a chave do 
desenvolvedor e uma contra-chave da Apple, que juntas garantem a legitimidade 
do seu aplicativo. Existem certificados para desenvolvimento, homologação e para 
produção, chamados nos termos em inglês de Development, Ad-hoc e Distribution 
respectivamente. Os certificados de desenvolvimento e produção você utilizará com 
certeza, enquanto que o de homologação (Ad-hoc) somente é necessário se dese- 
jarmos enviar o aplicativo para outras pessoas testá-lo antes de enviar oficialmente 
para a App Store. Porém, como é explicado neste capítulo, existe um limite anual 
para dispositivos de homologação. 

Para testar os aplicativos durante o processo de desenvolvimento, é possível uti- 
lizar o simulador de iOS que é instalado juntamente com o Xcode, o qual não precisa 
de um certificado específico, e rodá-lo no seu iPhone ou iPad através do certificado 
de desenvolvimento. 
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CAPÍTULO 13 


Rodando os aplicativos no seu 
IDispositivo 


Até agora todos os aplicativos que fizemos no livro rodaram no simulador do iOS 
que vem junto com o Xcode, e neste capítulo iremos ver os passos necessários para 
rodar os mesmos aplicativos diretamente no dispositivo, seja ele um iPhone, iPad ou 
iPod Touch ou qualquer outro iGadget que posteriormente a Apple venha a lançar. 
A razão de dedicarmos um capítulo inteiro para este assunto é que, ao contrário do 
simulador, os iDevices somente podem rodar aplicativos assinados digitalmente, o 
que requer tanto um certificado do desenvolvedor quanto um certificado da Apple, 
num processo chamado “provisionamento”, do termo em inglês “provisioning” 
Existem três tipos de provisionamento: para desenvolvimento, para testes e ho- 
mologação, e para distribuição na App Store. O de desenvolvimento permite rodar e 
debugar o aplicativo no dispositivo através de um cabo USB, diretamente pelo Xcode. 
O para testes e homologação, chamado de “Ad-hoc” é útil para distribuir o aplicativo 
para que outras pessoas possam ajudar a testar ou validar — o caso mais comum é o 
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cliente para o qual você está criando a app. Já o de distribuição (do inglês “distribu- 
tion”) é utilizado para enviar a versão final para a App Store de fato. 

Embora focaremos no provisionamento de desenvolvimento, os passos necessá- 
rios para o de Ad-Doc e Distribuição são virtualmente os mesmos. 





UTILIZE O SAFARI CASO TENHA PROBLEMAS EM ALGUNS PAS- 
sos 


Por algum motivo inexplicável e sem razão alguma, é necessário reali- 
zar os passos deste capítulo utilizando o Safari ao invés de qualquer outro 
browser, pois muito frequentemente o sistema online da Apple irá acu- 
sar que os arquivos enviados via upload estão corrompidos. Utilizando 
o Safari este problema não ocorre. 

Embora você talvez consiga realizar os procedimentos com sucesso 
com outro browser, o mais seguro mesmo é não abusar da sorte, e ir pelo 


Safari. 











Todos os passos descritos neste capítulo assumem que você já tenha a conta 
paga de desenvolvedor. 


13.1 CRIE E INSTALE O CERTIFICADO 


O primeiro passo é obter o certificado digital que será utilizado para criar as chaves 
de provisionamento. Acesse o iOS Provisioning Portal no endereço https://developer. 
apple.com/account/overview.action, clique no link Certificates no menu esquerdo, e 
depois no botão com o símbolo de soma, conforme a figura 13.1. Na tela que se abrir, 
selecione “iOS App Development” e clique em “Continue”. 
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Certificates, Identifiers & Profiles Account » 


iOS Apps = iOS Certificates a é + q 
$ Certificates el 1 Certificates Total 
All || Name | «Type | ..Expires 


Pending Rafael Steil iOS Development Oct 14, 2014 





Development 


Production 


JD identifiers 


App IDs 


Figura 13.1: Primeiro passo para solicitar o certificado digital 


A tela seguinte deverá ser uma com o título “About Creating a Certificate Signing 
Request (CSR)”, que contêm apenas uma explicação geral. Clique mais uma vez em 
“Continue”. 

Para criar o certificado primeiro precisamos enviar um arquivo de solicitação 
para a Apple, chamado de Certificate Signing Request (CSR), o qual contém uma 
chave de criptografia pública, que a Apple utilizará para emitir o certificado “de ver- 
dade”. Ele é o que ficará vinculado à sua conta de desenvolvedor para todos os pro- 
pósitos. No seu Mac, abra o aplicativo Keychain Access (localizado em Applications 
-> Utilities), e acesse o menu Keychain Access -> Certificate Assistant -> Request a 
Certificate from a Certificate Authority conforme a figura 13.2 


LOTEA File Edit View Window Help 
) About Keychain Access Keychain Access 


| 
Í Preferences... E, | 





| Keychain First Aid XEA 


Certificate Assistant > Open... 


Ticket Viewer XAK Create a Certificate... 
x Create a Certificate Authority... 
Services > Create a Certificate For Someone Else as a Certificate Authority... 


Hide Keychain Access 38H Request a Certificate From a Certificate Authority... 


Hide Others 8H Set the default Certificate Authority... 
“how A Evaluate a Certificate... 


Quit Keychain Access #Q 
taregoy q e 


Figura 13.2: Menu do Keychain para acessar 


Na tela que abrir, informe o seu endereço de e-mail no campo User email 
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address, e selecione a opção Saved to disk, conforme a figura 13.3. Depois 
clique no botão Continue, e o Keychain irá pedir para você salvar o arquivo 
CertificateSigningRequest.certSigningRequest em algum lugar. Este 
é o arquivo que deverá ser enviado para o portal de desenvolvimento. 


@ oo Certificate Assistant 
Certificate Information 


Enter information for the certificate you are requesting. 
Click Continue to request a certificate from the CA. 


User Email Address: |rafael@example.com v] 


Common Name: Rafael Steil 








CA Email Address: 


| Request is: ( ) Emailed to the CA 
| 


| (*) Saved to disk 
Dad “| Let me specify key pair information 


| Continue 





Figura 13.3: Primeira tela de criação da chave pública 


Após salvar o arquivo CertificateSigningRequest .certSigningRequest 
em disco, volte para a tela Certificates do portal de desenvolvimento, selecione o 
arquivo no botão Choose File, e clique no botão Submit, conforme a figura 13.4. 
Lembre-se de fazer este passo pelo Safari caso seja informada alguma mensagem de 
erro ao enviar. 
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Add iOS Certificate Q 


Select Type > Request > Generate Approval 


Certificate sge 
Generate your certificate. 


With the creation of your CSR, Keychain Access simultaneously generated a public and private 
key pair. Your private key is stored on your Mac in the login Keychain by default and can be 
viewed in the Keychain Access application under the "Keys" category. Your requested 
certificate will be the public half of your key pair. 


Upload CSR file. 
Select .certSigningRequ 






ile saved on your Mac. 


Choose File... [5 CertificateSigningRequest.certSigningRequest 


Figura 13.4: Enviando o CSR para a Apple 


Se tudo ocorrer sem problemas, o browser será redirecionado de volta para a tela 
de certificados, Se estiver aparecendo apenas a mensagem Pending Issuance, espere 
alguns minutos e dê refresh na tela, pois às vezes o sistema demora um pouco para 
liberar o download do certificado. 

Na tela da figura 13.5 clique em cima do nome do certificado para expandir as 
opções, e clique no botão “Download”. Para instalá-los basta dar um duplo clique no 
arquivo, e ele será importado para dentro do Keychain, conforme a figura 13.5. Note 
que deverá aparecer o “Apple Worldwide Developer Relations Certification Authority”, 
e o seu “iPhone Developer” do tipo Certificate e Private Key - se houver apenas algum 
deles (geralmente somente o Certificate), algum passo foi realizado incorretamente. 
Obs: o “Apple Worldwide Developer Relations Certification Authority” é instalado 
automaticamente pelo Xcode, portanto você não deve ter problemas. 
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e00 Keychain Access 
Eh Click to lock the login keychain. Q 
Keychains 
& login Apple Worldwide Developer Relations Certification Authority 
ĝ System Intermediate certificate authority 





Expires: Sunday, February 14, 2016 4:56:35 PM Brasilia Summer Time 


[E] System Roots 
© This certificate is valid 










Category Expires Keychain 












A Allitems & Apple Worldwide Developer Relations Certification Authority certificate Feb 14, 2016 4:56:35 PM login 
4. Passwords v [E] iPhone Developer: Rafael Steil | 9 certificate Aug 17, 2013 11:52:40 PM login 
— Secure Notes ç Rafael Steil private key -- login 
E My Certificates 


ç Keys 
EJ Certificates 








2 items 


(a) -3 anea 











Figura 13.5: Certificados instalados com sucesso 





CERTIFICADOS DE DESENVOLVIMENTO E DISTRIBUIÇÃO 


É importante frisar que existem dois certificados que você irá even- 
tualmente precisar: o primeiro é o de Desenvolvimento (Development), 
que acabamos de criar, e serve para a fase de desenvolvimento do aplica- 
tivo. O outro é o certificado de Distribuição (Distribution), utilizado para 
enviar para clientes homologarem antes de entrar na App Store e para en- 
viar para a App Store de vez, para o público final. O procedimento para 
criar o certificado de Distribuição é o mesmo do de Desenvolvimento, 
apenas devendo ser feito na aba “Distribution” do menu “Certificates”. 











13.2 CRIE A IDENTIDADE DO SEU APLICATIVO - APP IDs 


Uma parte vital do seu aplicativo é sua identificação, chamada de App ID, a qual é uti- 
lizada em todas as partes do ecossistema do iOS, inclusive para distribuição na App 
Store. O App ID é um identificador único, sendo que existe a possibilidade de criar 
um coringa para a sua conta, para que possa ser utilizado em diversos aplicativos 
(com restrições, porém). 

Para criar um novo App ID selecione a opção App IDs no menu lateral e em se- 
guida clique no botão representado pelo sinal de soma, que abrirá a página da figura 
13.6. O primeiro campo (App ID Description) é uma breve descrição do aplicativo 
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apenas para o seu próprio controle interno, e no segundo campo do formulário (App 
ID Prefix) selecione a opção Team ID. O terceiro campo (Bundle ID) será o identifi- 
cador em si, que por via de regra deve ser único dentre todos aplicativos existentes 
na App Store. A recomendação da própria Apple é utilizar um estilo de nomen- 
clatura que se assemelhe a um domínio de internet reverso seguido do nome do 
aplicativo em si, como br.com.example.MeuSuperApp. Pessoalmente vou um 





passo além e coloco como sufixo a plataforma (iPhone ou iPad) caso exista a possi- 
bilidade de lançar versões diferentes do aplicativo para iPhone e iPad — neste caso, 





o App ID ficaria sendo algo como com. rafaelsteil.MeuSuperApp. iphone e 
com.rafaelsteil.MeuSuperApp.ipad. 





ID Registering an App ID 


The App ID string contains two parts separated by a period (.)—an App ID Prefix that is 
defined as your Team ID by default and an App ID Suffix that is defined as a Bundle ID 
search string. Each part of an App ID has different and important uses for your app. Learn 
More 


App ID Description 


Name: 


App ID Prefix 
value: C 


App ID Suffix 


Figura 13.6: Formulário de criação de um novo App ID 


Após preencher o formulário e clicar no botão Submit você deverá voltar para a 
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tela de listagem anterior, na qual estará listado o aplicativo. Se você clicar em cima 
do nome dele, um box irá expandir mostrando o que está habilitado. Clique no 
botão Edit: para mostrar a tela onde é possível habilitar suporte a Push Notifications, 
iCloud:: e outras funcionalidades opcionais. Por hora não é necessário modificar 
nada, e podemos prosseguir para o próximo passo. 





APP ID CORINGA 


A Apple permite a criação de um App ID coringa, que pode ser uti- 
lizado para diversos aplicativos distintos sem que haja a necessidade de 
criar um ID especifico para cada um, o que é bastante vantajoso quando 
estamos criando vários aplicativos de testes. Para criar o App ID coringa 
basta selecionar a opção “Wildcard App ID” e inserir » (asterisco) no 
campo Bundle ID) da figura 13.6. 

Somente é possível criar um App ID coringa por conta. A Apple uti- 
liza o nome Catch All para se referenciar a este tipo de App ID. 











13.3 ADICIONANDO DISPOSITIVOS PARA DESENVOLVI- 
MENTO 


Para que seja possível rodar os seus aplicativos durante a fase de desenvolvimento, é 
necessário primeiro cadastrá-los no iOS Development Portal. O cadastro do disposi- 
tivo, que pode ser qualquer iDevice, é feito com o fornecimento de um ID único cha- 
mado UDID, do termo em inglês Unique Device Identifier (ou “Identificador único 
de dispositivo”), que é um código com 40 caracteres. Para localizá-lo, conecte o seu 
dispositivo ao Mac via cabo USB, abra o Xcode e acesse o menu Window -> Orga- 
nizer, e selecione-o na seção Devices do menu esquerdo, conforme mostra a figura 
13.7. O UDID é aquele código ao lado do texto “Identifier”. Copie o código (repare 
que é um campo de texto selecionável). 
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LIBRARY 


isioni E Prr paar 

EJ Provisioning Profiles Steil s iPhone 

ap Software Images 

» Device Logs Capacity 14.76 GB 

Screenshots Model iPhone 4 

TEAMS Serial Number. 

44, Rafael Steil ECID NETH 

DEVICES a Identifier] 9fd0ec59411bc7c8551b35fel|11bd5f6477746d1 
vm pego Software Version 5.1.1 (98206) 


[E] ProvisioningPProfiles 





Use for Development 
EJ Provisioning Profiles 
4 Applications 
EE Console 
» Device Logs 
Screenshots 


a 


Figura 13.7: Localizando o UDID do seu dispositivo 


Repare que na figura 13.7 existe um botão chamado Use for Development, que 
habilita o dispositivo para ser utilizado para tarefas de desenvolvimento, como rodar 
diretamente do Xcode e utilizar os recursos de debug. Certifique-se de selecionar 
esta opção. 

Tendo o UDID em mãos, acesse a opção Devices no portal e clique no botão 
com o símbolo de soma. No formulário que se abre coloque um nome descritivo 
do dispositivo no campo Name, e o UDID obtido anteriormente no campo UDID. 
Clique em Submit e ele deverá aparecer na listagem. 


13.4 LIMITE ANUAL DE DISPOSITIVOS 


A Apple impõe um limite anual de 100 dispositivos para serem utilizados para tes- 
tes e homologação, permitindo resetar o cadastro uma única vez por ano, após a 
renovação da conta de desenvolvimento. Este número de 100 dispositivos é sempre 
incremental durante o ano, nem mesmo diminuindo se você remover algum regis- 
tro. Embora para o desenvolvedor independente esta restrição não chega a ser um 
grande problema, no caso de empresas que atendem a diversos clientes é um fator 
bastante preocupante, pois uma vez atingido o limite anual não há qualquer maneira 
de conseguir cadastrar mais dispositivos, sendo necessário esperar o período de re- 
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novação da conta. 

Depois de renovar a conta do iOS Developer Program, a seção Devices do portal 
irá mostrar um aviso em amarelo informando que você tem agora a opção de re- 
mover “de verdade” os registros que deseja. Faça isso antes de adicionar qualquer 
outro dispositivo, pois ao adicionar um novo registro a sua conta ficará travada por 
mais um ano. 


13.5 CRIE O CERTIFICADO DE PROVISIONAMENTO 


Agora que já temos a nossa chave privada, o certificado da Apple, o App ID e o 
dispositivo de testes devidamente registrado, o último passo é obter o arquivo de 
provisionamento (Provisioning Profile). Ele é utilizado para assinar digitalmente o 
aplicativo de tal forma que seja possível rodá-lo nos dispositivos cadastrados sem 
passar pela App Store. Para tanto, acesse o menu Development da seção “Provisioning 
Profiles” no menu lateral, e em seguida clique no botão com o símbolo de soma. 

No formulário que abrir selecione “iOS App Development” e clique no botão 
“Continue”, na próxima tela selecione o “App ID”, na tela seguinte marque o certi- 
ficado a utilizar (deverá haver um único). Depois de clicar em “Continue” mais uma 
vez, selecione o dispositivo na lista e clique novamente no botão de continuar. Por 
último, coloque um nome descritivo para o profile, e clique no botão “Generate”. 





RECONFIGURE O PROVISIONING APÓS ADICIONAR UM NOVO 
DISPOSITIVO 


Lembre-se que toda vez que você cadastrar um novo dispositivo é ne- 
cessário reconfigurar o arquivo de provisionamento, bastando para isso 
clicar no link Edit e depois em Modify na tela principal do link Provisi- 
oning do menu lateral (a mesma mostrada na figura 13.8), e por último 
marcar os dispositivos desejados. 











Na listagem dos provisionamentos, clique em cima do nome do que foi criado 
no passo anterior, e em seguida no botão “Download”. 

Caso tudo tenha ocorrido com sucesso você deverá ver o arquivo de provisiona- 
mento listado na tela principal do menu Provisioning, e o botão Download habilitado, 
conforme mostra a figura 13.8. Faça o download deste arquivo (ele terá a extensão 
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«mobileprovision) e dê duplo clique para abri-lo no Organizer do Xcode. Após a im- 
portação, ele deverá estar listado com o status Valid Profile, na seção Provisioning 
Profiles da Library do organizer, conforme mostra a figura 13.8. 


soo Organizer - Devices 


(za fm ag 
Devices Repositories Projects Archives Documentation 
LIBRARY Q7 Profile Name 


EB Provisioning Profiles Name a Platform Creation Expiration | App Identifier Status 
àp Software Images Rafael Catch All DEV iOS Profile 8/18/12 8/18/13 RYY75P75WK.* © Valid profile 
» Device Logs 


Screenshots 








TEAMS 
AR Rafael Steil 


DEVICES 


My Mac 
V Œ| 10.7.3 (110500) 


E] Provisioning Profiles 
Steil's iPhone 

v E 5i. (98208) 
» Device Logs 
Screenshots 





Figura 13.8: Provisionamento importado corretamente 


13.6 ÁSSOCIE O ARQUIVO DE PROVISIONAMENTO NO 
XCODE 


O último passo para poder rodar os aplicativos nos dispositivos cadastrados é confi- 
gurar o Xcode para utilizar o arquivo de provisionamento apropriado. Abra as pro- 
priedades do projeto desejado, selecione o Target apropriado (por padrão somente 
existirá um, correspondente ao nome do projeto) no menu lateral, e selecione a aba 
Build Settings. Nela, você deverá localizar a seção Code Signing -> Code Signing Iden- 
tity, que deverá ter o valor ::Don't Code Sign”, o qual iremos modificar. Veja a figura 
para referência 13.9. 
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eoo 1 E TremeTreme.xcodeproj Fi 
err | =] Running TremeTreme on Steil's iPhone | 3 EIS) 
a a No Issues = = ni 





mia > | EjTremeTreme 





















4] PROJECT Summary info | Build Settings | Build Phases Build Rules 


E TremeTreme CED a | combined 


Y I T target, OSSDKS.L 
v l TremeTreme 

















[hj TremeTremeView.h Taans Setting yA Resolved sÀ TremeTreme E TremeTreme iOS Default 
|m) TremeTremeViewm C) é WArchitectures 
[R] AppDelegate.h Architectures Standard (armv7) - + Standard (armv?) - — 
[m] AppDelegate.m [m] Base SDK Latest iOS (iOS 5.1) + Latest iOS (iOS 5.1) + 
[hj viewController.h Y Build Options. 
[mi ViewController.m C Compiler for C/C++ /Objective-C Apple LLVM compiler- $ 4 
A ViewController.xib Y Validate Built Product <Multiple values> + 
» [L Supporting Files Debug Noé 
P G Frameworks 2 Release Yes $ 
> C Products Y Code Signing. 


Y Code Signing Identity 
Debug 
Any iOS SDK $ 
Release Do $ 
Any iOS SDK $ Don't Code Sign $ Don't Code Sign + 
Y Deployment 
Installation Directory Applications [Applications 
Y Strip Debug Symbols During Copy <Multipie values» $ <Multiple values> $ | Yes + 
Debug No? No + ves $ 
Release Yes $ ves Yes $ 
Strip Linked Product 
Targeted Device Family 

























iOS 5.14 iOS 5.1 $ 


iOS Deployment Target 
Y Packaging 

Info.plist File TremeTreme/TremeT... TremeTreme/TremeT... 
Product Name TremeTreme | 











TremeTreme TremeTreme 
















app app 





Add Target Validate Settings Add Build Setting 





Figura 13.9: Localizando a seção para seleção do arquivo de provisionamento 


Na linha do Code Signing Identity clique em cima de Don't Code Sign para abrir o 
menu de seleção de perfis de provisionamento, e selecione a opção iPhone Developer, 
conforme mostra a figura 13.10. A opção iPhone Developer se encarrega de automa- 
ticamente utilizar o perfil de provisionamento mais apropriado. Por via de regra, ele 
irá verificar o valor do campo Bundle Identifier na aba Summary e comparar com 
os perfis existentes, utilizando algum identificador que seja igual ao cadastrado na 
seção App IDs no portal da Apple (veja a figura 13.6). Caso contrário, irá utilizar o 
Catch All (coringa) caso exista. 
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REFORÇANDO A IMPORTÂNCIA DO BUNDLE IDENTIFIER 


Preste bastante atenção em relação ao fluxo que é descrito neste ca- 
pítulo, pois uma vírgula errada poderá fazer você perder muitas horas 
de trabalho (e fios de cabelo) tentando encontrar o que deu errado. Isso 
é especialmente válido para o Bundle Identifier, o qual deve ser corres- 
pondente no Xcode ao valor cadastrado na seção App IDs no portal da 
Apple. 

Por exemplo, se no terceiro campo da figura 13.6 você inseriu o valor 
“com.exemplo. MeuSuper App. iphone”, é exatamente este valor que deverá 
ser utilizado no campo Bundle Identifier no Xcode (Propriedades do pro- 
jeto -> Summary -> Bundle Identifier). 











* Don't Code Sign 





iPhone Developer 
iPhone Distribution 


Rafael Catch All DEV 
iPhone Developer: Rafael Steil (XCWPXZSR8K) 


Other... 


Figura 13.10: Selecionando o perfil iPhone Developer 


Uma vez selecionado o perfil, o resultado deverá ficar conforme o da figura 13.11 
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a DOPER ii aci 
Debug No $ [No $ 
| Release Yes $ Yes$ No $ 
|_YCode Signing 
Y Code Signing Identity iPhone Developer 4 mm iPhone Developer $ 
Debug iPhone Developer $ iPhone Developer £ 
Any iOS SDK $ iPhone Developer $ iPhone Developer $ 
Release iPhone Developer $ iPhone Developer $ 
Any iOS SDK $ iPhone Developer $ iPhone Developer $ 
| ¥ Deployment 
Installation Directory / Applications |/Applicat 
| Y Strip Debug Symbols Du... <Multiple values> $ |<Multiple Ra] Yes + 
Debug No + Nos Yes + 
| Release Yes $ Yes + Yes $ 





Figura 13.11: Perfil selecionado corretamente para todas as opções 


13.7 RODE SEU APLICATIVO NO DISPOSITIVO 


Agora que temos tudo configurado, para rodar o aplicativo no dispositivo basta 
conectá-lo ao Mac via cabo USB e selecioná-lo como destino no Xcode, conforme 
mostrado na figura 13.12. Compile o projeto (Command + B) e rode-o utilizando 
Command + R. Caso apareça uma caixa de diálogo pedindo permissão para utilizar 
a sua chave (aquela criada anteriormente, no início do capítulo), selecione a opção 
“Always Allow” (“Permitir sempre”). 





















e00 
(») (m) ( TremeTreme > iPhone 5.1 Simulator | | =æ | | 
á = 
Run Stop Scheme Breakpoints 
m| 4 > | [H TremeTreme Y TremeTreme > Y Steil's iPhone 
























PROJECT F iPad 5.1 Simulator 
Edit Scheme... iPhone 5.1 Simulator 
iii CB a New Scheme... i 
TARGETS Setting | Manage Schemes... 
dh) TremeTremeView.m A a YArchitecture S ps 
lh] AppDelegate.h Architectur 
[m] AppDelegate.m Base SDK 
ih) ViewController.h ¥ Build Optior 
[m] ViewController.m 
+ ViewController.xib ¥ Validate BL 
> [| Supporting Files Debug 
> C] Frameworks Balsa 
> C] Products | ¥Code Signin 
Y Code Signi 


Figura 13.12: Selecionando o dispositivo para rodar o aplicativo 
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Caso o Xcode aponte algum problema como o da figura 13.13, verifique se o perfil 
iPhone Developer está selecionado em todas as linhas da seção Code Signing Identity, 
conforme a figura 13.11. 


mi| 4 | | À Build target TremeTreme : 11:49:05 AM 


All All Messages Errors Only Q 
(Recent | sages QUE Errors Only 





Y Q Check dependencies © OU 
Check dependencies 


CodeSign error: code signing is required for product type 'Application' in SDK 'iOs 5.1' 
O CodeSign error: code signing is required for product type 'Application' in SDK "OS 5.1' 


Activity Log Complete 8/18/12 11:49 AM 
1 error 





Figura 13.13: Falha ao compilar devido a erro na configuração do perfil de provisio- 
namento 


13.8 VERIFICANDO A INSTALAÇÃO DOS PERFIS NO DISPOSI- 
TIVO 
Para verificar os perfis instalados em um determinado dispositivo basta acessar a app 


Settings, ir na seção General e procurar pelos perfis no final da tela, conforme mostra 
a figura 13.14. 








Settings General General Provisioning 
Passcode Lock On > — 
pä Rafael Catch All DEV 

Restrictions On > A é 

DÃ£S over: 
Dato & Time ? Received 18/08/2012 
Keyboard R Expires 18/08/2013 
International > 
Accessibility > 
Profile Rafael Catch All DEV > 
Reset > 


Figura 13.14: Localização do perfil de provisionamento no dispositivo 
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Uma palavra final + bônus 


Uma das lições (vinda em forma de conselho) mais importantes que aprendi logo 
que comecei a trabalhar com desenvolvimento de software, e a qual de certa forma 
me moldou em diversos aspectos, foi a seguinte: o nosso trabalho é encontrar so- 
luções, não reclamar que tudo é difícil e que “não dá para fazer”, ficando sem ação. 
Se o problema está muito difícil, quebre-o em pedaços menores até que seja possível 
resolvê-lo. E se não dá para fazer da maneira solicitada, então encontre uma forma 
possível. 

As empresas têm problemas que precisam ser solucionados, e para isso tentam 
contratar as melhores pessoas possíveis. Você, ao fazer parte da equipe, tem a res- 
ponsabilidade de encontrar e desenvolver a solução. Se não fizer, quem fará? Pense 
nisso. 

Abraço, Rafael 


14.1. Bônus - livros e links Casa do Código 





14.1 BÔNUS - LIVROS E LINKS 
Conhecimento nunca é demais, e abaixo estão alguns livros e sites extremamente 


úteis. 


e Learn Objective-C for Java Developers, ISBN 978-1430223696 (http://amzn. 
to/PwFyQI) 


Objective-C for Absolute Beginners, ISBN 978-1430236535 (http://amzn.to/ 
QamoTm) 


Stackoverflow (http://bit.ly/oW30Ca) 


Principal documentação da Apple sobre desenvolvimento iOS (http://bit.ly/ 
dGPsCm) 


Guia da Apple para desenvolvimento de aplicativos (http://bit.ly/PXZEW4) 


http://www.icodeblog.com (blog e artigos) 


http://iosdevelopertips.com (blog e artigos) 


http://maniacdev.com (blog e artigos) 


http://www.raywenderlich.com (blog bastante famoso, com artigos muito 
bem elaborados) 


http://www.cocoacontrols.com (muitos componentes e projetos Open 
Source) 
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